Salesforce (Tealium-Provided Credentials) Connector Setup Guide
This article describes how to set up the Salesforce (Tealium-Provided Credentials) connector.
Prerequisites
Before you configure this connector, a Salesforce administrator must install the Tealium AudienceStream package in each Salesforce org that you connect. The package adds the Tealium AudienceStream external client app that this connector uses to authenticate. Install the package once per org, before anyone clicks Establish Connection.
To install the package, complete the following steps:
- Log in to the Salesforce org that you want to connect as an administrator.
- Open the install page for your org type:
- Production or Developer Edition org: Install the Tealium AudienceStream package
- Sandbox: Install the Tealium AudienceStream package in a sandbox
- Select who to install the package for. The user who clicks Establish Connection must be included.
- Click Install and wait for the installation to finish.
If the package is not installed, the connection fails and Salesforce returns the following error: External client app is not installed in this org.
Configuration
Go to the connector marketplace and add a new connector. For more information, see About connectors.
This connector uses Tealium-provided OAuth credentials. You do not need to create or configure a Salesforce connected app. To use your own Salesforce connected app instead, see Salesforce (Customer-Provided Credentials).
After adding the connector, configure the following settings:
- Account Type: Select an account type: Developer, Production, or Sandbox.
After you configure the connector, click Done.
Click Establish Connection to initiate the OAuth process and follow the prompts.
For more information about sandboxes, see Salesforce: Create a Sandbox for Account Engagement.
Actions
| Action name | Visitor profile | Event data |
|---|---|---|
| Insert into Custom Object | ✓ | ✗ |
| Update Custom Object | ✓ | ✗ |
| Insert Lead | ✓ | ✗ |
| Update Lead | ✓ | ✗ |
| Upsert Lead | ✓ | ✗ |
| Convert Lead to Contact | ✓ | ✗ |
| Add Lead to Campaign | ✓ | ✗ |
| Insert Contact | ✓ | ✗ |
| Update Contact | ✓ | ✗ |
| Add Contact to Campaign | ✓ | ✗ |
| Send Entire Visitor to Custom Apex | ✓ | ✗ |
| Send Entire Event to Custom Apex | ✗ | ✓ |
| Upsert into Custom Object (non-batched) | ✓ | ✓ |
| Upsert into Custom Object (batched) | ✓ | ✓ |
Insert into Custom Object
Parameters
| Parameter | Description |
|---|---|
| Custom Object Name | Name of Salesforce custom object. |
| Insert Data Map | Select and map Tealium attributes to the Salesforce fields of your custom object. Each mapped field is sent as part of the record insert. |
Update Custom Object
Parameters
| Parameter | Description |
|---|---|
| Custom Object Name | Name of Salesforce custom object. |
| Custom Object ID | ID of Salesforce custom object. |
| Update Fields | Map Tealium attributes to the Salesforce fields to update in the record. |
Insert Lead
Parameters
| Parameter | Description |
|---|---|
| Insert Data to Set | Select and map Tealium attributes to Salesforce lead fields for record creation. |
| Append Data Map |
|
| Append Data Map - Entry Label |
|
| Select Target Assignment Rule |
|
Update Lead
Parameters
| Parameter | Description |
|---|---|
| Lead ID | (Required) Select the Salesforce field used to identify the lead to update. |
| Update Data to Set | Select and map Tealium attributes to Salesforce lead fields for record update. |
| Append Data Map |
|
| Append Data Map - Entry Label |
|
| Select Target Assignment Rule |
|
Upsert Lead
Parameters
| Parameter | Description |
|---|---|
| Update Lookup ID |
|
| Update Data to Set |
|
| Insert Data to Set |
|
| Append Data Map |
|
| Append Data Map - Entry Label |
|
| Select Target Assignment Rule |
|
Convert Lead to Contact
Parameters
| Parameter | Description |
|---|---|
| Lead ID | (Required) Select the Salesforce field used to identify the lead to convert. |
| Send Email to the Owner | Send email to the owner. |
Add Lead to Campaign
Parameters
| Parameter | Description |
|---|---|
| Lead ID | (Required) Select the Salesforce field used to identify the lead. |
| Campaign | Select the target campaign for the lead. |
Insert Contact
Parameters
| Parameter | Description |
|---|---|
| Insert Contact |
|
| Append Data Map - Entry Label |
|
Update Contact
Parameters
| Parameter | Description |
|---|---|
| Contact ID | (Required) Select the Salesforce field used to identify the contact to update. |
| Update Data to Set | Select and map Tealium attributes to Salesforce contact fields for record update. |
| Append Data Map |
|
| Append Data Map - Entry Label |
|
Add Contact to Campaign
Parameters
| Parameter | Description |
|---|---|
| Contact ID | (Required) Select the Salesforce field used to identify the contact. |
| Campaign | Select the target campaign for the contact. |
Send Entire Visitor to Custom Apex
Parameters
| Parameter | Description |
|---|---|
| Apex Endpoint URL | (Required) The Custom Apex REST endpoint. Enter either a full URL (for example, https://myorg.my.salesforce.com/services/apexrest/TealiumVisitor) or a relative path (for example, /services/apexrest/TealiumVisitor). The path must contain /services/apexrest/. |
| Include Current Visit Data | Include current visit data with visitor data. |
| Print Attribute Names | By default, the attribute keys are used. Enable to use attribute names as keys instead. |
Send Entire Event to Custom Apex
Parameters
| Parameter | Description |
|---|---|
| Apex Endpoint URL | (Required) The Custom Apex REST endpoint. Enter either a full URL (for example, https://myorg.my.salesforce.com/services/apexrest/TealiumEvent) or a relative path (for example, /services/apexrest/TealiumEvent). The path must contain /services/apexrest/. |
| Print Attribute Names | By default, the attribute keys are used. Enable to use attribute names as keys instead. |
Upsert into Custom Object (non-batched)
Parameters
| Parameter | Description |
|---|---|
| Custom Object | Select the custom object to perform an upsert. |
Lookup
| Parameter | Description |
|---|---|
| Lookup | Data to look up external ID. |
Data mapping
| Parameter | Description |
|---|---|
| Data mapping | Data to modify when upserting records. |
Upsert into Custom Object (batched)
Batch limits
This action uses batched requests to support high-volume data transfers to the vendor. Parallel processing may result in events reaching the vendor out of sequence. Add a sequence value to events if ordering is important. For more information, see Batched actions. Requests are queued until one of the following thresholds is met or the profile is published:
- Max number of requests: 1000
- Max time since oldest request: 5 minutes
- Max size of requests: 10 MB
Parameters
| Parameter | Description |
|---|---|
| Custom Object | Select the custom object to perform an upsert. |
Lookup
| Parameter | Description |
|---|---|
| Lookup | Data to look up external ID. |
Data mapping
| Parameter | Description |
|---|---|
| Data mapping | Data to modify when upserting records. |
This page was last updated: November 18, 2026