---
schema_version: "1"
id: 527b99bad0df2e10180633731270156229e96d864bc22bd00f8eba2e27636172
title: Subscriber
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/subscriber_appex.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/subscriber_appex.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 948e6f51a060f066e4be0d3c19ecbd9ce7870f698e7baa329d723a6a2c5335d7
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# Subscriber

A person subscribed to receive email or SMS communication. Subscriber represents a single instance of a subscriber.

### Properties

| Name                          | Data Type                                                  | Description                                                                                                             |
| ----------------------------- | ---------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `Addresses`                   | Array of [SubscriberAddress](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/subscriberaddress.md) objects | Indicates addresses belonging to a subscriber.                                                                          |
| `Attributes`                  | Array of [Attribute](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/attribute.md) objects                 | Specifies attributes associated with an object.                                                                         |
| `Client`                      | [ClientID](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/clientid.md)                                    | Specifies the account ownership and context of an object.                                                               |
| `CorrelationID`               | String                                                     | Identifies correlation of objects across several requests.                                                              |
| `CreatedDate`                 | DateTime                                                   | The date and time when the object was created.                                                                          |
| `CustomerKey`                 | String                                                     | User-supplied unique identifier for an object within an object type.                                                    |
| `EmailAddress`                | String                                                     | Contains the email address for a subscriber.                                                                            |
| `EmailTypePreference`         | [EmailType](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/emailtype.md)                                  | Indicates the email format.                                                                                             |
| `GlobalUnsubscribeCategory`   | [GlobalUnsubscribeCategory](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/globalunsubscribecategory.md)  | Indicates how the application handles a globally unsubscribed subscriber.                                               |
| `ID`                          | Int                                                        | Read-only legacy identifier for an object. Not supported on all objects.                                                |
| `Lists`                       | Array of [SubscriberList](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/subscriberlist.md) objects       | Defines lists a subscriber resides on.                                                                                  |
| `Locale`                      | [Locale](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/locale.md)                                        | Contains the locale information for an Account.                                                                         |
| `ModifiedDate`                | DateTime                                                   | Last time object information was modified.                                                                              |
| `ObjectID`                    | String                                                     | System-controlled, read-only text string identifier for object.                                                         |
| `Owner`                       | [Owner](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/owner.md)                                          | Describes account ownership of subscriber in an on-your-behalf account.                                                 |
| `PartnerKey`                  | String                                                     | Unique identifier provided by partner for an object. This property is accessible only via API.                          |
| `PartnerProperties`           | Array of [APIProperty](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/apiproperty.md) objects             | A collection of metadata supplied by the client and stored by the system. These properties are accessible only via API. |
| `PartnerType`                 | String                                                     | Defines partner associated with a subscriber.                                                                           |
| `PrimaryEmailAddress`         | [EmailAddress](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/emailaddress.md)                            | Indicates primary email address for a subscriber.                                                                       |
| `PrimarySMSAddress`           | SMSAddress                                                 | Indicates primary SMS address for a subscriber.                                                                         |
| `PrimarySMSPublicationStatus` | [SubscriberAddressStatus](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/subscriberaddressstatus.md)      | Indicates the subscriber's modality status.                                                                             |
| `Status`                      | [SubscriberStatus](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/subscriberstatus.md)                    | Defines status of object.                                                                                               |
| `SubscriberKey`               | String                                                     | Identification of a specific subscriber.                                                                                |
| `SubscriberTypeDefinition`    | [SubscriberTypeDefinition](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/subscribertypedefinition.md)    | Specifies if a subscriber resides in an integration, such as Salesforce or Microsoft Dynamics CRM.                      |
| `UnsubscribedDate`            | DateTime                                                   | Represents date subscriber unsubscribed from a list.                                                                    |