--- schema_version: "1" id: bcef30737cad92cc46388dfb35d6029bc2e0967d35f92e389f0a4d0b4af4333a title: MessagingEndUser collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_messagingenduser.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_messagingenduser.htm source_site: developer.salesforce.com content_type: documentation content_hash: 2e3709d994ef7d71b1da43e74bdd74b742ca91f04665a30e45c52a27cbb84e0a description: Represents a single address—such as a phone number or Facebook page—communicating with a single Messaging channel. This object is available in API version 40.0 and later. --- # MessagingEndUser Represents a single address—such as a phone number or Facebook page—communicating with a single Messaging channel. This object is available in API version 40.0 and later. ![Note](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/images/icon_note.png) #### Note This object is available for Einstein Conversation Insights customers whose data is stored natively on the Salesforce Platform. If you turned on Einstein Conversation Insights for the first time starting in Spring ’26, this object is available to query and access using Salesforce tools. For existing ECI customers, data migration and access to related Salesforce Platform objects is scheduled to begin in Summer ’26. ## Supported Calls create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert() ## Fields | Field | Details | | --- | --- | | AccountId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description ID of the Account associated with this Messaging end user. Available in API version 43.0 and later. This field is a relationship field. Relationship Name Account Relationship Type Lookup Refers To Account | | AuthenticatedEndUserId | Type reference Properties Filter, Group, Nillable, Sort Description ID of the authenticated user associated with this messaging end user. This field is a relationship field. Relationship Name AuthenticatedEndUser Relationship Type Lookup Refers To User | | ContactId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description ID of the associated Contact. Available in API version 43.0 and later. This field is a relationship field. Relationship Name Contact Relationship Type Lookup Refers To Contact | | HasInitialResponseSent | Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether an initial response has been sent to the Messaging end user (true) or not (false). | | IsFullyOptedIn | Type boolean Properties Defaulted on create, Filter, Sort Description Indicates whether the Messaging end user has opted in to receiving messages (true) or not (false). This field compares the related messaging channel’s consent requirement to the user’s consent status; if the user’s status meets the channel’s required consent level, IsFullyOptedIn is set to true. Available in API version 48.0 and later. | | IsOptedOut | Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether the Messaging end user has opted out of receiving messages. Available in API version 48.0 and earlier. Use MessagingConsentStatus and IsFullyOptedIn instead. | | IsoCountryCode | Type string Properties Create, Filter, Group, Nillable, Sort Description The ISO country code associated with the Messaging end user. | | LastReferencedDate | Type dateTime Properties Filter, Nillable, Sort Description The timestamp for when the current user last viewed a record related to this record. | | LastViewedDate | Type dateTime Properties Filter, Nillable, Sort Description The timestamp for when the current user last viewed this record. If this value is null, this record might only have been referenced (LastReferencedDate) and not viewed. | | LeadId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description ID of the associated lead. Available in API version 57.0 and later. This field is a relationship field. Relationship Name Lead Relationship Type Lookup Refers To Lead | | Locale | Type string Properties Create, Filter, Group, Nillable, Sort Description Reserved for future use. | | Language | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The preferred language of the messaging user who participated in the messaging session. Supported for Enhanced Chat and Apple Messages for Business only. | | MessageType | Type picklist Properties Create, Filter, Group, Restricted picklist, Sort Description Type of message. Possible values are: - AppleBusinessChat—Represents Apple Messages for Business. - Custom—Represents Bring Your Own Channel. Available in API version 58.0 and later. - EmbeddedMessaging—Represents Enhanced Chat. Available in API version 50.0 and later. - Email—Available in API version 66.0 and later. - Facebook - MsCopilot—Available in API version 67.0 and later. - Phone - Rcs—Available in API version 67.0 and later. - Text - Voice - WhatsApp | | MessagingChannelId | Type reference Properties Create, Filter, Group, Sort Description The ID of the Messaging channel associated with the Messaging end user. This is a relationship field. Relationship Name MessagingChannel Relationship Type Lookup Refers To MessagingChannel | | MessagingConsentStatus | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The consent status of the messaging user. This field is available in API version 48.0 and later. Possible values are: - DoublyOptedIn - ExplicitlyOptedIn - ImplicitlyOptedIn - OptedOut | | MessagingExternalUserKey | Type string Properties Filter, Group, Nillable Description The business-scoped user identifier provided by external messaging platforms such as Meta. This opaque, stable identifier uniquely represents the end user within the context of your business relationship on that platform. Available in API version 63.0 and later. | | MessagingPlatformKey | Type string Properties Create, Filter, Group, Sort Description The phone number, Facebook page ID, or unique key associated with this Messaging end user. | | Name | Type string Properties Create, Filter, Group, idLookup, Sort, Update Description The name of the Messaging end user. Because this field is editable, we don’t recommend referencing it in automation. Instead, use the Messaging Platform Key. | | OwnerId | Type reference Properties Create, Defaulted on create, Filter, Group, Sort, Update Description ID of the owner associated with this Messaging end user. This is a polymorphic relationship field. Relationship Name Owner Relationship Type Lookup Refers To Group, User | | ProfilePictureUrl | Type url Properties Create, Filter, Group, Nillable, Sort Description The URL of the Messaging end user's profile picture. | ## Associated Objects This object has the following associated objects. Unless noted, they’re available in the same API version as this object. [MessagingEndUserChangeEvent](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_change_event.htm "A ChangeEvent object is available for each object that supports Change Data Capture. You can subscribe to a stream of change events using Change Data Capture to receive data tied to record changes in Salesforce. Changes include record creation, updates to an existing record, deletion of a record, and undeletion of a record. A change event isn’t a Salesforce object—it doesn’t support CRUD operations or queries. It’s included in the object reference so you can discover which Salesforce objects support change events.") (API version 62.0) Change events are available for the object. [MessagingEndUserHistory](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_history.htm "StandardObjectNameHistory is the model for all history objects associated with standard objects. These objects represent the history of changes to the values in the fields of a standard object.") History is available for tracked fields of the object. [MessagingEndUserOwnerSharingRule](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_ownersharingrule.htm "StandardObjectNameOwnerSharingRule is the model for all owner sharing rule objects associated with standard objects. These objects represent a rule for sharing a standard object with users other than the owner.") Sharing rules are available for the object. [MessagingEndUserShare](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_share.htm "StandardObjectNameShare is the model for all share objects associated with standard objects. These objects represent a sharing entry on the standard object.") Sharing is available for the object.