{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Owners, phones, and communication","description":"Guides and API reference for the DataSift (REISift) Core API and SiftMap API."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"owners-phones-and-communication","__idx":0},"children":["Owners, phones, and communication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Owner records hold the person side of a property record: names, mailing address, phones, emails, communication history, offers, and the message board."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"owner-crud-and-actions","__idx":1},"children":["Owner CRUD and actions"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Method"},"children":["Method"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Path"},"children":["Path"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["GET"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/owner/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List owners"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/owner/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create an owner"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["GET"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/owner/{uuid}/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Owner detail"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PATCH"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/owner/{uuid}/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Partial update"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["DELETE"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/owner/{uuid}/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delete"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["GET"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/owner/{uuid}/logs/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Owner change log"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/owner/{uuid}/add-property/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Link the owner to a property"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/owner/{uuid}/contact/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Record a contact event"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/owner/{uuid}/do-not-mail-ever/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Permanent mail suppression"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/owner/{uuid}/verify-email/{email}/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Verify an email address"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"phones-and-emails","__idx":2},"children":["Phones and emails"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Phones and emails are managed with upsert and remove actions on the owner:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Method"},"children":["Method"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Path"},"children":["Path"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/owner/{uuid}/upsert-phones/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Add or update phone numbers"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/owner/{uuid}/remove-phones/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Remove phone numbers"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/owner/{uuid}/upsert-emails/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Add or update emails"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/owner/{uuid}/remove-emails/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Remove emails"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Phone type definitions (mobile, landline, VOIP and so on) are listed at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/internal/phone/type/"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"phone-tags---the-dial-priority-system","__idx":3},"children":["Phone tags - the dial-priority system"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Phone tags are account-wide labels applied to individual phone numbers (not to records). They are the backbone of dial prioritization: score numbers externally, tag them by tier, then build call queues by filtering on phone tags."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Method"},"children":["Method"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Path"},"children":["Path"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["GET"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/phone/tag/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List phone tags"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/phone/tag/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create a phone tag"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PATCH"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/phone/tag/{uuid}/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rename or edit"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["DELETE"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/phone/tag/{uuid}/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delete"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["GET"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/phone/tag/{uuid}/properties-count/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["How many records carry a phone with this tag"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/phone/add-phone-tag/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Apply a tag to phone numbers"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/property/{uuid}/add-phone-tag/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Apply from the property side"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/owner/{uuid}/add-phone-tag/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Apply from the owner side"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["properties-count"]}," endpoint is your verification tool: after a bulk tagging run, compare the count against the number you intended to tag."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"sms","__idx":4},"children":["SMS"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send and manage SMS per owner:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Method"},"children":["Method"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Path"},"children":["Path"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["GET"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/owner/{owner_uuid}/sms/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["SMS history with this owner"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/owner/{owner_uuid}/sms/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Send an SMS"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/owner/{owner_uuid}/sms/{uuid}/cancel/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cancel a queued message"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/owner/{owner_uuid}/sms/{uuid}/resend/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Resend"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sending requires a connected texting integration (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/integrations"},"children":["Integrations"]},"). SMS content follows carrier compliance rules; keep opt-out handling in your workflow and respect ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dnc"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["opt_out"]}," flags on the owner."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"message-board","__idx":5},"children":["Message board"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Internal team notes on an owner (not messages to the owner):"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Method"},"children":["Method"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Path"},"children":["Path"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["GET"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/owner/{owner_uuid}/message/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List board messages"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/owner/{owner_uuid}/message/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Post a message"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PATCH"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/owner/{owner_uuid}/message/{uuid}/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Edit"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["DELETE"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/owner/{owner_uuid}/message/{uuid}/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delete"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/owner/{owner_uuid}/message/{uuid}/pin/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pin to top"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/owner/{owner_uuid}/message/{uuid}/unpin/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unpin"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"offers","__idx":6},"children":["Offers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Offers recorded against an owner are readable at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/internal/owner/{owner_uuid}/offer/"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/internal/owner/{owner_uuid}/offer/{uuid}/"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"contacts-the-address-book","__idx":7},"children":["Contacts (the address book)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Separate from owners, the account has a general contact book under ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/contacts/contact/"]}," with its own tags (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/contacts/tag/"]},") and tag folders: contact CRUD, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["add-tags"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["remove-tags"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]},", record-order navigation, and per-tag ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contacts-count"]},". The shape mirrors the property tag system; see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/datasift"},"children":["API reference"]}," for the full list."]}]},"headings":[{"value":"Owners, phones, and communication","id":"owners-phones-and-communication","depth":1},{"value":"Owner CRUD and actions","id":"owner-crud-and-actions","depth":2},{"value":"Phones and emails","id":"phones-and-emails","depth":2},{"value":"Phone tags - the dial-priority system","id":"phone-tags---the-dial-priority-system","depth":2},{"value":"SMS","id":"sms","depth":2},{"value":"Message board","id":"message-board","depth":2},{"value":"Offers","id":"offers","depth":2},{"value":"Contacts (the address book)","id":"contacts-the-address-book","depth":2}],"frontmatter":{"seo":{"title":"Owners, phones, and communication"}},"lastModified":"2026-11-01T21:43:02.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/owners-and-phones","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}