# Salesforce Marketing Cloud

Salesforce Marketing Cloud is a digital marketing platform that automates email marketing, social media, apps, websites, and more.

Salesforce Marketing Cloud integration replicates data using the [Salesforce Marketing Cloud both REST API and SOAP API](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/apis-overview.html).

See the [Schema](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#Schema) section for a list of objects available for replication.

## Preparing for authentication

To access your data, you need to authenticate the connection with your account credentials.

Information noteMake sure that the account you use has read access to the tables you want to fetch.

Before you create connections in Qlik Talend Cloud, make sure you have the following:

* A Salesforce Professional, Corporate, or Enterprise license (required to use the Salesforce Marketing Cloud API).
* A Salesforce Marketing Cloud Administrator user, or a System Administrator user in Salesforce.
* An External Client App created in Salesforce. To integrate with Salesforce, external applications must use an External Client App (not a package).

The following instructions are available only in the Salesforce Lightning Experience menu. If you are using Salesforce Classic, switch to Salesforce Lightning Experience.

To retrieve your client ID and client secret:

1. Switch to Salesforce Lightning Experience if you are using Salesforce Classic.
2. Log into your [Salesforce Marketing Cloud](https://mc.login.exacttarget.com/hub-cas/login?&service=https%3a%2f%2fauth.exacttargetapis.com%2fv2%2fauthorize%3fclient_id%3dhbw6vmsadg5epio6bd1eg4uc%26redirect_uri%3dhttps%253A%252F%252Fmc.exacttarget.com%252Fcloud%252Fauth_redirect%26response_type%3dcode%26state%3deyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhdXRob3JpemVTdGFydFRpbWUiOjE3NzMyNDUxMjMwMjYsImtleSI6IkZva2RQWFE3ZzFXYVBia3pEZEs4bCIsInJlZGlyZWN0SGFuZGxlciI6Imh0dHBzOi8vbWMuZXhhY3R0YXJnZXQuY29tL2Nsb3VkL2F1dGhfcmVkaXJlY3QiLCJyZWRpcmVjdFVyaSI6Imh0dHBzOi8vbWMuZXhhY3R0YXJnZXQuY29tL2Nsb3VkLz9oYXNoPWxvZ2dlZC1pbkl3PT0ifQ.M8_PaOcLuB62gYJq3AqmpgshPzPdtMwZqeDBn99Pk9o) account.
3. In Setup, navigate to Apps &gt; App Manager, and then click New External Client App.
4. Configure the app:
   * Enter a name.
   * Set Distribution State to Local.
   * Under API (Enable OAuth Settings), select Enable OAuth and set OAuth Scopes to Full access.
   * Under Flow Enablement, select Enable Client Credentials Flow.
5. Click Create.
6. Once the external app is created, navigate to Settings &gt; OAuth Settings &gt; Consumer Key and Secret.
7. When prompted, verify your identity using one of your registered methods.
8. Copy and paste your client ID and client secret into a secured file.
9. Navigate to Policies &gt; Edit &gt; OAuth Policies, and then enable Enable Client Credentials Flow.
10. In Run As (Username), enter your email, and then click Save.

To enable REST API access:

1. Log into your [Salesforce Marketing Cloud](https://mc.login.exacttarget.com/hub-cas/login?&service=https%3a%2f%2fauth.exacttargetapis.com%2fv2%2fauthorize%3fclient_id%3dhbw6vmsadg5epio6bd1eg4uc%26redirect_uri%3dhttps%253A%252F%252Fmc.exacttarget.com%252Fcloud%252Fauth_redirect%26response_type%3dcode%26state%3deyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhdXRob3JpemVTdGFydFRpbWUiOjE3NzMyNDUxMjMwMjYsImtleSI6IkZva2RQWFE3ZzFXYVBia3pEZEs4bCIsInJlZGlyZWN0SGFuZGxlciI6Imh0dHBzOi8vbWMuZXhhY3R0YXJnZXQuY29tL2Nsb3VkL2F1dGhfcmVkaXJlY3QiLCJyZWRpcmVjdFVyaSI6Imh0dHBzOi8vbWMuZXhhY3R0YXJnZXQuY29tL2Nsb3VkLz9oYXNoPWxvZ2dlZC1pbkl3PT0ifQ.M8_PaOcLuB62gYJq3AqmpgshPzPdtMwZqeDBn99Pk9o) account.
2. In Setup, navigate to Apps &gt; External Client Apps &gt; Settings.
3. Enable Allow access to External Client App consumer secrets via REST API.

## Creating the connection

For more information, see [Connecting to SaaS applications](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Landing/connecting-web-applications.htm).

1. Fill in the required connection properties.

2. Provide a name for the connection in Connection name.

3. Select Open connection metadata to define metadata for the connection when it has been created.

4. Click Create.

Connection settings

| Setting | Description |
| --- | --- |
| Data gateway | Select a Data Movement gateway if required by your use case.<br><br>Information note<br><br>This field is not available with the Qlik Talend Cloud Starter subscription, as it does not support Data Movement gateway. If you have another subscription tier and do not want to use Data Movement gateway, select None.<br><br>For information on the benefits of Data Movement gateway and use cases that require it, see [Qlik Data Gateway - Data Movement](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm). |
| Start Date | Enter the date, in the format `MM/DD/YYYY`, from which the data must be replicated from your source to your target. |
| Client ID | Client ID. |
| Client Secret | Client secret. |
| Tenant Subdomain | The tenant subdomain for your Salesforce Marketing Cloud account.<br><br>Example: https://subdomain.auth.marketingcloudapis.com, enter subdomain. |

## Schema

Schemas and naming conventions can change from version to version. It is recommended to verify your version before continuing.

Depending on your destination, table and column names may not appear as they are outlined below.

### campaigns

The `campaigns` table contains information about the campaigns in your Salesforce Marketing Cloud account.

| **Replication Method** | Full Table |
| --- | --- |
| **Primary Key** | id |
| **Replication Key** | modifiedDate |
| **Useful links** | [Salesforce Marketing Cloud API method](https://developer.salesforce.com/Content/atlas.en-us.noversion.mc-apis.meta/mc-apis/campaign.htm "Opens in new tab: Salesforce Marketing Cloud API method") |

campaigns table schema

| **campaignCode**<br><br><br>STRING |
| --- |
| **color**<br><br><br>STRING |
| **createdDate**<br><br><br>STRING |
| **description**<br><br><br>STRING |
| **id**<br><br><br>STRING |
| **modifiedDate**<br><br><br>STRING |
| **name**<br><br><br>STRING |

### content\_areas

The `content_areas` table contains information about the reusable content sections in your Salesforce Marketing Cloud account.

| **Replication Method** | CDC |
| --- | --- |
| **Primary Key** | ID |
| **Replication Key** | ModifiedDate |
| **Useful links** | [Salesforce Marketing Cloud API method](https://developer.salesforce.com/Content/atlas.en-us.noversion.mc-apis.meta/mc-apis/contentarea.htm "Opens in new tab: Salesforce Marketing Cloud API method") |

content\_areas table foreign keys

| Join content\_areas with | on |
| --- | --- |
| [emails](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#emails) | ```<br>content_areas.ID = emails.ContentAreaIDs<br>```<br><br>```<br>content_areas.CategoryID = emails.CategoryID<br>``` |
| [folders](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#folders) | ```<br>content_areas.CategoryID = folders.ID<br>```<br><br>```<br>content_areas.CategoryID = folders.ParentFolder<br>``` |
| [lists](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#lists) | ```<br>content_areas.CategoryID = lists.Category<br>``` |

content\_areas table schema

| **BackgroundColor**<br><br><br>STRING |
| --- |
| **BorderColor**<br><br><br>STRING |
| **BorderWidth**<br><br><br>INTEGER |
| **CategoryID**<br><br><br>INTEGER |
| **Cellpadding**<br><br><br>INTEGER |
| **Cellspacing**<br><br><br>INTEGER |
| **Content**<br><br><br>STRING |
| **CreatedDate**<br><br><br>STRING |
| **CustomerKey**<br><br><br>STRING |
| **FontFamily**<br><br><br>STRING |
| **HasFontSize**<br><br><br>BOOLEAN |
| **ID**<br><br><br>INTEGER |
| **IsBlank**<br><br><br>BOOLEAN |
| **IsDynamicContent**<br><br><br>BOOLEAN |
| **IsLocked**<br><br><br>BOOLEAN |
| **IsSurvey**<br><br><br>BOOLEAN |
| **Key**<br><br><br>STRING |
| **ModifiedDate**<br><br><br>STRING |
| **Name**<br><br><br>STRING |
| **ObjectID**<br><br><br>STRING |
| **PartnerProperties**<br><br><br>ARRAY<br><br>This is a nested data structure:<br><br><ul><li>Name: STRING</li><li>Value: STRING</li></ul> |
| **Width**<br><br><br>INTEGER |

### data\_extension

The `data_extension` table contains information about the data extensions in your Salesforce Marketing Cloud account. A table will be created for each [data extension](https://help.salesforce.com/articleView?id=mc_cab_data_extensions.htm&type=5) in your Salesforce Marketing Cloud account.

For example: If there are two data extensions named `MobileAddress` and `MobileSubscription`, two tables would be created: `data_extension._MobileAddress` and `data_extension._MobileSubscription`

**Note**: Retrieving data extension data requires [**Read, Write** permissions for Data Extensions](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#add-api-component-to-package).

| **Replication Method** | Full Table |
| --- | --- |
| **Primary Key** | \_CustomObjectKey |
| **Useful links** | [Salesforce Marketing Cloud API method](https://developer.salesforce.com/Content/atlas.en-us.noversion.mc-apis.meta/mc-apis/dataextensionobject.htm "Opens in new tab: Salesforce Marketing Cloud API method") |

data\_extension table schema

| **CategoryID**<br><br><br>INTEGER |
| --- |
| **\_CustomObjectKey**<br><br><br>STRING |

### emails

The `emails` table contains information about the emails in your Salesforce Marketing Cloud account.

| **Replication Method** | CDC |
| --- | --- |
| **Primary Key** | ID |
| **Replication Key** | ModifiedDate |
| **Useful links** | [Salesforce Marketing Cloud API method](https://developer.salesforce.com/Content/atlas.en-us.noversion.mc-apis.meta/mc-apis/email.htm "Opens in new tab: Salesforce Marketing Cloud API method") |

emails table foreign keys

| Join emails with | on |
| --- | --- |
| [content_areas](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#content-areas) | ```<br>emails.ContentAreaIDs = content_areas.ID<br>```<br><br>```<br>emails.CategoryID = content_areas.CategoryID<br>``` |
| [sends](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#sends) | ```<br>emails.ID = sends.EmailID<br>```<br><br>```<br>emails.ClonedFromID = sends.EmailID<br>``` |
| [folders](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#folders) | ```<br>emails.CategoryID = folders.ID<br>```<br><br>```<br>emails.CategoryID = folders.ParentFolder<br>``` |
| [lists](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#lists) | ```<br>emails.CategoryID = lists.Category<br>``` |

emails table schema

| **CategoryID**<br><br><br>INTEGER |
| --- |
| **CharacterSet**<br><br><br>STRING |
| **ClonedFromID**<br><br><br>INTEGER |
| **ContentAreaIDs**<br><br><br>ARRAY<br><br>This is a nested data structure. |
| **ContentCheckStatus**<br><br><br>STRING |
| **CreatedDate**<br><br><br>STRING |
| **CustomerKey**<br><br><br>STRING |
| **EmailType**<br><br><br>STRING |
| **HTMLBody**<br><br><br>STRING |
| **HasDynamicSubjectLine**<br><br><br>BOOLEAN |
| **ID**<br><br><br>INTEGER |
| **IsActive**<br><br><br>BOOLEAN |
| **IsHTMLPaste**<br><br><br>BOOLEAN |
| **ModifiedDate**<br><br><br>STRING |
| **Name**<br><br><br>STRING |
| **ObjectID**<br><br><br>STRING |
| **PartnerProperties**<br><br><br>ARRAY<br><br>This is a nested data structure:<br><br><ul><li>Name: STRING</li><li>Value: STRING</li></ul> |
| **PreHeader**<br><br><br>STRING |
| **Status**<br><br><br>STRING |
| **Subject**<br><br><br>STRING |
| **SyncTextWithHTML**<br><br><br>BOOLEAN |
| **TextBody**<br><br><br>STRING |
| **\_\_AdditionalEmailAttribute1**<br><br><br>STRING |
| **\_\_AdditionalEmailAttribute2**<br><br><br>STRING |
| **\_\_AdditionalEmailAttribute3**<br><br><br>STRING |
| **\_\_AdditionalEmailAttribute4**<br><br><br>STRING |
| **\_\_AdditionalEmailAttribute5**<br><br><br>STRING |

### events

The `events` table contains information about the events in your Salesforce Marketing Cloud account.

When events are replicated to the destination, they are split into the following tables: `BounceEvent`, `ClickEvent`, `OpenEvent`, `SentEvent`, and `UnsubEvent`.

| **Replication Method** | CDC |
| --- | --- |
| **Primary Keys** | EventType<br><br>EventDate<br><br>SendID<br><br>SubscriberKey |
| **Replication Key** | EventDate |
| **Useful links** |  |

events table foreign keys

| Join events with | on |
| --- | --- |
| [list_sends](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#list-sends) | ```<br>events.SendID = list_sends.SendID<br>``` |
| [sends](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#sends) | ```<br>events.SendID = sends.ID<br>``` |
| [list_subscribers](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#list-subscribers) | ```<br>events.SubscriberKey = list_subscribers.SubscriberKey<br>``` |
| [subscribers](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#subscribers) | ```<br>events.SubscriberKey = subscribers.ID<br>``` |

events table schema

| **BatchID**<br><br><br>INTEGER |
| --- |
| **CorrelationID**<br><br><br>STRING |
| **EventDate**<br><br><br>DATE-TIME |
| **EventType**<br><br><br>STRING |
| **SendID**<br><br><br>INTEGER |
| **SubscriberKey**<br><br><br>STRING |
| **URL**<br><br><br>STRING |

### folders

The `folders` table contains information about the folders in your Salesforce Marketing Cloud account.

| **Replication Method** | CDC |
| --- | --- |
| **Primary Key** | ID |
| **Replication Key** | ModifiedDate |
| **Useful links** | [Salesforce Marketing Cloud API method](https://developer.salesforce.com/Content/atlas.en-us.noversion.mc-apis.meta/mc-apis/datafolder.htm "Opens in new tab: Salesforce Marketing Cloud API method") |

folders table foreign keys

| Join folders with | on |
| --- | --- |
| [content_areas](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#content-areas) | ```<br>folders.ID = content_areas.CategoryID<br>```<br><br>```<br>folders.ParentFolder = content_areas.CategoryID<br>``` |
| [emails](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#emails) | ```<br>folders.ID = emails.CategoryID<br>```<br><br>```<br>folders.ParentFolder = emails.CategoryID<br>``` |
| [lists](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#lists) | ```<br>folders.ID = lists.Category<br>```<br><br>```<br>folders.ParentFolder = lists.Category<br>``` |

folders table schema

| **AllowChildren**<br><br><br>BOOLEAN |
| --- |
| **ContentType**<br><br><br>STRING |
| **CreatedDate**<br><br><br>STRING |
| **CustomerKey**<br><br><br>STRING |
| **Description**<br><br><br>STRING |
| **ID**<br><br><br>INTEGER |
| **ModifiedDate**<br><br><br>STRING |
| **Name**<br><br><br>STRING |
| **ObjectID**<br><br><br>STRING |
| **ParentFolder**<br><br><br>INTEGER |
| **PartnerProperties**<br><br><br>ARRAY<br><br>This is a nested data structure:<br><br><ul><li>Name: STRING</li><li>Value: STRING</li></ul> |
| **Type**<br><br><br>STRING |

### list\_sends

The `list_sends` table contains information about the completed sends for lists in your Salesforce Marketing Cloud account.

| **Replication Method** | CDC |
| --- | --- |
| **Primary Keys** | ListID<br><br>SendID |
| **Replication Key** | ModifiedDate |
| **Useful links** | [Salesforce Marketing Cloud API method](https://developer.salesforce.com/Content/atlas.en-us.noversion.mc-apis.meta/mc-apis/listsend.htm "Opens in new tab: Salesforce Marketing Cloud API method") |

list\_sends table foreign keys

| Join list\_sends with | on |
| --- | --- |
| [lists](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#lists) | ```<br>list_sends.ListID = lists.ID<br>``` |
| [list_subscribers](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#list-subscribers) | ```<br>list_sends.ListID = list_subscribers.ListID<br>``` |
| [subscribers](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#subscribers) | ```<br>list_sends.ListID = subscribers.ListIDs<br>``` |
| [events](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#events) | ```<br>list_sends.SendID = events.SendID<br>``` |
| [sends](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#sends) | ```<br>list_sends.SendID = sends.ID<br>``` |

list\_sends table schema

| **CreatedDate**<br><br><br>STRING |
| --- |
| **CustomerKey**<br><br><br>STRING |
| **ExistingUndeliverables**<br><br><br>INTEGER |
| **ExistingUnsubscribes**<br><br><br>INTEGER |
| **ForwardedEmails**<br><br><br>INTEGER |
| **HardBounces**<br><br><br>INTEGER |
| **ID**<br><br><br>INTEGER |
| **InvalidAddresses**<br><br><br>INTEGER |
| **ListID**<br><br><br>INTEGER |
| **MissingAddresses**<br><br><br>INTEGER |
| **ModifiedDate**<br><br><br>STRING |
| **NumberDelivered**<br><br><br>INTEGER |
| **NumberSent**<br><br><br>INTEGER |
| **ObjectID**<br><br><br>STRING |
| **OtherBounces**<br><br><br>INTEGER |
| **PartnerProperties**<br><br><br>ARRAY<br><br>This is a nested data structure:<br><br><ul><li>Name: STRING</li><li>Value: STRING</li></ul> |
| **SendID**<br><br><br>INTEGER |
| **SoftBounces**<br><br><br>INTEGER |
| **UniqueClicks**<br><br><br>INTEGER |
| **UniqueOpens**<br><br><br>INTEGER |
| **Unsubscribes**<br><br><br>INTEGER |

### list\_subscribers

The `list_subscribers` table contains information about the lists associated with a specific subscriber in your Salesforce Marketing Cloud account.

| **Replication Method** | CDC |
| --- | --- |
| **Primary Keys** | ListID<br><br>SubscriberKey |
| **Replication Key** | ModifiedDate |
| **Useful links** | [Salesforce Marketing Cloud API method](https://developer.salesforce.com/Content/atlas.en-us.noversion.mc-apis.meta/mc-apis/listsubscriber.htm "Opens in new tab: Salesforce Marketing Cloud API method") |

list\_subscribers table foreign keys

| Join list\_subscribers with | on |
| --- | --- |
| [lists](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#lists) | ```<br>list_subscribers.ListID = lists.ID<br>``` |
| [list_sends](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#list-sends) | ```<br>list_subscribers.ListID = list_sends.ListID<br>``` |
| [subscribers](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#subscribers) | ```<br>list_subscribers.ListID = subscribers.ListIDs<br>```<br><br>```<br>list_subscribers.SubscriberKey = subscribers.ID<br>``` |
| [events](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#events) | ```<br>list_subscribers.SubscriberKey = events.SubscriberKey<br>``` |

list\_subscribers table schema

| **CreatedDate**<br><br><br>STRING |
| --- |
| **ID**<br><br><br>INTEGER |
| **ListID**<br><br><br>INTEGER |
| **ModifiedDate**<br><br><br>STRING |
| **ObjectID**<br><br><br>STRING |
| **PartnerProperties**<br><br><br>ARRAY<br><br>This is a nested data structure:<br><br><ul><li>Name: STRING</li><li>Value: STRING</li></ul> |
| **Status**<br><br><br>STRING |
| **SubscriberKey**<br><br><br>STRING |

### lists

The `lists` table contains information about the lists in your Salesforce Marketing Cloud account.

| **Replication Method** | CDC |
| --- | --- |
| **Primary Key** | ID |
| **Replication Key** | ModifiedDate |
| **Useful links** | [Salesforce Marketing Cloud documentation](https://developer.salesforce.com/Content/atlas.en-us.noversion.mc-apis.meta/mc-apis/list.htm)<br><br>[Salesforce Marketing Cloud API method](https://developer.salesforce.com/Content/atlas.en-us.noversion.mc-apis.meta/mc-apis/retrieve.htm "Opens in new tab: Salesforce Marketing Cloud API method") |

lists table foreign keys

| Join lists with | on |
| --- | --- |
| [content_areas](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#content-areas) | ```<br>lists.Category = content_areas.CategoryID<br>``` |
| [emails](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#emails) | ```<br>lists.Category = emails.CategoryID<br>``` |
| [folders](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#folders) | ```<br>lists.Category = folders.ID<br>```<br><br>```<br>lists.Category = folders.ParentFolder<br>``` |
| [list_sends](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#list-sends) | ```<br>lists.ID = list_sends.ListID<br>``` |
| [list_subscribers](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#list-subscribers) | ```<br>lists.ID = list_subscribers.ListID<br>``` |
| [subscribers](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#subscribers) | ```<br>lists.ID = subscribers.ListIDs<br>``` |

lists table schema

| **Category**<br><br><br>INTEGER |
| --- |
| **CreatedDate**<br><br><br>STRING |
| **Description**<br><br><br>STRING |
| **ID**<br><br><br>INTEGER |
| **ListClassification**<br><br><br>STRING |
| **ListName**<br><br><br>STRING |
| **ModifiedDate**<br><br><br>STRING |
| **ObjectID**<br><br><br>STRING |
| **PartnerProperties**<br><br><br>ARRAY<br><br>This is a nested data structure:<br><br><ul><li>Name: STRING</li><li>Value: STRING</li></ul> |
| **SendClassification**<br><br><br>STRING |
| **Type**<br><br><br>STRING |

### sends

The `sends` table contains information about the email sends in your Salesforce Marketing Cloud account.

| **Replication Method** | CDC |
| --- | --- |
| **Primary Key** | ID |
| **Replication Key** | ModifiedDate |
| **Useful links** | [Salesforce Marketing Cloud API method](https://developer.salesforce.com/Content/atlas.en-us.noversion.mc-apis.meta/mc-apis/send.htm "Opens in new tab: Salesforce Marketing Cloud API method") |

sends table foreign keys

| Join sends with | on |
| --- | --- |
| [emails](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#emails) | ```<br>sends.EmailID = emails.ID<br>```<br><br>```<br>sends.EmailID = emails.ClonedFromID<br>``` |
| [events](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#events) | ```<br>sends.ID = events.SendID<br>``` |
| [list_sends](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#list-sends) | ```<br>sends.ID = list_sends.SendID<br>``` |

sends table schema

| **CreatedDate**<br><br><br>STRING |
| --- |
| **EmailID**<br><br><br>INTEGER |
| **EmailName**<br><br><br>STRING |
| **FromAddress**<br><br><br>STRING |
| **FromName**<br><br><br>STRING |
| **ID**<br><br><br>INTEGER |
| **IsAlwaysOn**<br><br><br>BOOLEAN |
| **IsMultipart**<br><br><br>BOOLEAN |
| **ModifiedDate**<br><br><br>STRING |
| **PartnerProperties**<br><br><br>ARRAY<br><br>This is a nested data structure:<br><br><ul><li>Name: STRING</li><li>Value: STRING</li></ul> |
| **SendDate**<br><br><br>DATE-TIME |
| **SentDate**<br><br><br>DATE-TIME |
| **Status**<br><br><br>STRING |
| **Subject**<br><br><br>STRING |

### subscribers

The `subscribers` table contains information about the subscribers (people subscribed to receive email and/or SMS communication) in your Salesforce Marketing Cloud account.

| **Replication Method** | CDC |
| --- | --- |
| **Primary Key** | ID |
| **Replication Key** | ModifiedDate |
| **Useful links** | [Salesforce Marketing Cloud API method](https://developer.salesforce.com/Content/atlas.en-us.noversion.mc-apis.meta/mc-apis/subscriber.htm "Opens in new tab: Salesforce Marketing Cloud API method") |

subscribers table foreign keys

| Join subscribers with | on |
| --- | --- |
| [lists](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#lists) | ```<br>subscribers.ListIDs = lists.ID<br>``` |
| [list_sends](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#list-sends) | ```<br>subscribers.ListIDs = list_sends.ListID<br>``` |
| [list_subscribers](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#list-subscribers) | ```<br>subscribers.ListIDs = list_subscribers.ListID<br>```<br><br>```<br>subscribers.ID = list_subscribers.SubscriberKey<br>``` |
| [events](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/WebApplications/Connecting-Salesforce-Marketing-Cloud.htm#events) | ```<br>subscribers.ID = events.SubscriberKey<br>``` |

subscribers table schema

| **Addresses**<br><br><br>ARRAY<br><br>This is a nested data structure:<br><br><ul><li>Address: STRING</li><li>AddressStatus: STRING</li><li>AddressType: STRING</li></ul> |
| --- |
| **Attributes**<br><br><br>ARRAY<br><br>This is a nested data structure:<br><br><ul><li>Name: STRING</li><li>Value: STRING</li></ul> |
| **CreatedDate**<br><br><br>STRING |
| **CustomerKey**<br><br><br>STRING |
| **EmailAddress**<br><br><br>STRING |
| **EmailTypePreference**<br><br><br>STRING |
| **ID**<br><br><br>INTEGER |
| **ListIDs**<br><br><br>ARRAY<br><br>This is a nested data structure. |
| **Locale**<br><br><br>STRING |
| **ModifiedDate**<br><br><br>STRING |
| **ObjectID**<br><br><br>STRING |
| **PartnerKey**<br><br><br>STRING |
| **PartnerProperties**<br><br><br>ARRAY<br><br>This is a nested data structure:<br><br><ul><li>Name: STRING</li><li>Value: STRING</li></ul> |
| **PartnerType**<br><br><br>STRING |
| **PrimaryEmailAddress**<br><br><br>STRING |
| **PrimarySMSAddress**<br><br><br>STRING |
| **PrimarySMSPublicationStatus**<br><br><br>STRING |
| **Status**<br><br><br>STRING |
| **SubscriberKey**<br><br><br>STRING |
| **SubscriberTypeDefinition**<br><br><br>STRING |
| **UnsubscribedDate**<br><br><br>STRING |