- Help Center
- Apps
Salesforce Marketing Cloud Next Content Sync
Salesforce Marketing Cloud Next Content Sync
The Salesforce Marketing Cloud Next Content Sync app syncs content from Contentful into Salesforce Marketing Cloud Next Marketing Objects, and keeps them up to date every time an entry is published or unpublished. Your marketing team can use approved content in campaigns without copying it by hand.
Overview
The Salesforce Marketing Cloud Next Content Sync app turns any Contentful content type into a source of records for a Salesforce Marketing Object. An admin links a content type to a Marketing Object from the app's page, either by creating a new Marketing Object from the content type or by choosing one that already exists. The app then copies every published entry into it.
From then on, sync is automatic. Publishing an entry updates its records in the Marketing Object, and unpublishing an entry marks its records inactive. Admins can still change which fields sync, re-run the backfill, or unlink the content type at any time. Editors can see whether an entry syncs on publish from a status panel in the entry sidebar.
Sync goes one way, from Contentful to Marketing Cloud Next. Changes made to records in Marketing Cloud Next don't sync back to Contentful, and the next publish or backfill overwrites them. Contentful stays the source of truth.
The app connects to Salesforce with OAuth through the Contentful External Client App, so access follows the permissions of the Salesforce user who connects it. No passwords or API keys are stored in Contentful.
The app works best when your content types are already modeled the way you want the data to appear in Marketing Cloud Next. Each content type maps to one Marketing Object, and each content type field maps to one Marketing Object field.
Requirements
Space Admin access to the Contentful space where you're installing the app.
A Salesforce org with Marketing Cloud Next and Marketing Objects enabled.
The Contentful External Client App (ECA) package installed in that Salesforce org. This is what lets Contentful connect to Salesforce with OAuth. See Step 1.
A Salesforce user who can sign in through the ECA, create Marketing Objects, and write records to them. This is usually a Salesforce admin. The app acts as this user, including when it syncs on publish.
Your Salesforce org's My Domain URL, for example https://yourcompany.my.salesforce.com. You can find it in Salesforce under Setup › My Domain › Current My Domain URL.
Usage
Step 1: Install the Contentful External Client App in Salesforce
The External Client App (ECA) is a small Salesforce package that registers Contentful as a trusted app in your org. You only need to install it once per Salesforce org.
Log in to Salesforce as an admin.
Open the Contentful ECA install link: https://login.salesforce.com/packaging/installPackage.apexp?p0=04ti8000002OjXVAA0
When Salesforce asks who to install the package for, choose Install for Admins Only. You can give other users access later.
Click Install and approve the third-party access prompt if one is shown.
Wait for the confirmation that installation is complete. Large orgs may get an email instead.
Step 2: Install the Salesforce Marketing Cloud Next Content Sync app in Contentful
Log in to the Contentful web app.
Under Platform, click Apps.
Under Marketplace, click All apps.
Find the Salesforce Marketing Cloud Next Content Sync app and click its card. The App details window is displayed.
Click Install. The Manage app access window is displayed.
Under Environments, select the environments where you want to install the app.
Click Authorize access. The configuration screen is displayed.
Step 3: Enter your Salesforce API host and install
Under 1. Salesforce API host, enter your org's My Domain URL in Salesforce API host (My Domain URL), for example https://yourcompany.my.salesforce.com. Enter the host only, with no path or query string. If you leave off https://, the app adds it for you.
Click Install in the top right.
Saving adds two content types to your space: Marketing Object Registry (do not delete) and Sync Linkage (do not delete). The app uses them to remember which content type syncs to which Marketing Object. Manage them from the app's page rather than editing those entries directly. Deleting either content type stops syncing for every linked content type.
Step 4: Connect to Salesforce
The Connect button stays disabled until the app is installed, because the connection is stored on the app installation. It unlocks as soon as Step 3 finishes, with no reload needed.
Under 2. Connect to Salesforce, click Connect.
A popup opens Salesforce's sign-in screen. Sign in as the Salesforce user from the requirements above, in the same org as the API host you entered in Step 3.
Approve access.
The popup closes and the button changes to Connected.
If the popup doesn't open, make sure popups aren't blocked for your Contentful domain.
Step 5: Sync your first content type
Open the app's page from Apps › Salesforce Marketing Cloud Next Content Sync. The page lists every content type in the space with its sync status. Use the search box or the Filter by link status menu to find a content type, then open its three dots menu (⋯).
To create a new Marketing Object from a content type:
Choose Create new Marketing Object.
Select the fields you want to sync.
Click Create & Sync. The app creates the Marketing Object in Salesforce, waits until Salesforce reports it's ready, links the content type, and copies every published entry into it.
To link a content type to an existing Marketing Object:
Choose Link to an existing Marketing Object.
Pick the Marketing Object from the list. Objects that aren't linked yet are listed separately from objects already used by other content types.
If the Marketing Object wasn't built from this content type, the app shows a warning listing fields that will stay empty and fields that won't sync. Review it before you continue.
Click Link and backfill.
From this point on, publishing an entry of the linked content type syncs it to Salesforce. Linking a content type also adds a sync status panel to that content type's entry sidebar. You don't need to configure the sidebar yourself.
Step 6: Manage a linked content type
Open the three dots menu (⋯) on any linked content type to:
Backfill now: copy every published entry into the Marketing Object again. Use this after bulk content changes, or to catch up after a sync on publish didn't go through.
Edit synced fields: change which fields sync. The app re-syncs the content type after you save, and future publishes use the new field list.
Change Marketing Object: link the content type to a different Marketing Object, then backfill.
Unlink: stop syncing this content type, including on publish. Nothing is deleted in Salesforce.
After each action, the app shows how many records were processed and how many failed.
If any Marketing Objects aren't linked to a content type, for example after an unlink, the app's page lists them in a collapsible section below the content types. Link one from a content type's ⋯ menu.
Step 7: Check an entry's sync status
Open any entry of a linked content type. The app's panel in the entry sidebar shows one of these messages:
Sidebar message | What it means |
|---|---|
Publishing syncs this entry to Salesforce. | The content type is linked and Salesforce is connected. Publishing the entry updates its records, and unpublishing marks them inactive. |
This content type isn't linked to a Marketing Object. | Publishing won't sync this entry. A Space Admin needs to link the content type from the app's page first. |
Salesforce isn't connected, so publishing won't sync this entry. Ask a space admin to connect it on this app's configuration screen. | The shared Salesforce connection is missing. Publishing won't sync until a Space Admin reconnects on the app's configuration screen. Run Backfill now after reconnecting to catch up. |
NOTE: There is no button to sync a single entry. To update Salesforce, publish the entry.
How content is synced
One direction. Content flows from Contentful to Marketing Cloud Next only. Nothing in Marketing Cloud Next is read back into Contentful.
One record per locale. Each locale of an entry is written as its own record in the Marketing Object, so localized content stays separate.
Records are matched by key. Each record has a key built from the entry ID and the locale. Syncing the same entry again updates its existing records instead of creating duplicates.
Publishing updates records. Publishing an entry adds or updates its records using the published version of the entry. Changes that aren't published yet don't sync.
Unpublishing deactivates records. Unpublishing an entry sets IsActive__c to false on its records instead of deleting them. Filter on IsActive__c = true wherever you use the content in Marketing Cloud Next.
Deleting an entry. Contentful requires you to unpublish an entry before deleting it, so a deleted entry's records stay in Salesforce marked inactive.
Other actions also sync. Linking a content type, Backfill now, and Edit synced fields sync every published entry of the content type.
Timing. A publish usually reaches Salesforce within about 30 seconds.
Supported field types. Short text, long text, number, integer, date, and boolean fields sync. Reference fields, media fields, and Rich Text fields aren't offered in the field list yet.
Limitations
Sync is one way, from Contentful to Marketing Cloud Next. Edits made in Marketing Cloud Next are overwritten by the next publish or backfill.
Reference, media, and Rich Text fields can't be synced yet.
Records are never deleted. Unpublishing an entry marks its records inactive. Unlinking a content type stops syncing but leaves the Marketing Object and its records in place. Remove them in Marketing Cloud Next if you need to.
If a sync on publish fails, for example because Salesforce is disconnected or the connected user lost access, it isn't retried and the entry doesn't show an error. Run Backfill now on the app's page to catch up.
One Salesforce org can be connected per app installation. The connection is shared by everyone who uses the app in that space.
Very large content types (many thousands of entries) can take several minutes to backfill.
Troubleshooting
The Connect button is disabled
The app isn't installed yet. Enter your API host and click Install in the top right (Step 3). Connect unlocks as soon as the install finishes.
Connect doesn't complete, or the popup closes without connecting
Make sure popups aren't blocked for your Contentful domain. Confirm the Contentful External Client App is installed in your Salesforce org (Step 1) and that the user you're signing in as is allowed to use it.
An error about the API host when saving
Enter your My Domain URL as shown in Setup › My Domain › Current My Domain URL, such as https://yourcompany.my.salesforce.com, with no path or query string. You can leave off https://, but don't use http://. The field isn't a sign-in page, so login.salesforce.com and test.salesforce.com aren't accepted. Don't use an Experience Cloud site domain (ending in .my.site.com) either; it doesn't serve the Salesforce APIs the app needs.
Creating a Marketing Object fails
Confirm Marketing Objects are enabled in your org and that the connected Salesforce user has permission to create them. If Salesforce says the object is still being created, wait a few minutes and check its status in Salesforce before trying again.
Publishing an entry didn't update Salesforce
Check the entry sidebar first. If it says the content type isn't linked, link it from the app's page. If it says Salesforce isn't connected, reconnect on the configuration screen. Then run Backfill now on the app's page to sync anything that was missed. Allow about 30 seconds after publishing before checking Salesforce.
The sidebar says Salesforce isn't connected
The connection was removed or the connected user's access changed. A Space Admin can open the app's configuration screen, click Connect, and sign in again. Run Backfill now afterwards to catch up on publishes made while disconnected.
A backfill or sync reports failed records
The connected Salesforce user may not have permission to write to the Marketing Object or some of its fields. Check the user's access in Salesforce, then run Backfill now again.
I can't find the synced records
Synced records are stored in the Marketing Object you linked, in Marketing Cloud Next. Search for the Marketing Object by the name shown on the app's page.
FAQs
Does the app sync automatically when I publish an entry?
Yes. Once a content type is linked, publishing an entry updates its records and unpublishing marks them inactive.
Can I sync a single entry without publishing it?
No. Only published content syncs. Publish the entry to update Salesforce.
Why are my records still there after I unpublished an entry?
The app never deletes records. It sets IsActive__c to false instead. Filter on IsActive__c = true to exclude them.
Do edits in Marketing Cloud Next Content sync back to Contentful?
No. Sync goes one way, from Contentful to Marketing Cloud Next. Contentful stays the source of truth, and the next publish or backfill overwrites edits made in Marketing Cloud Next.
Can I link more than one content type to the same Marketing Object?
Each content type links to one Marketing Object. Marketing Objects already used by another content type are listed separately in the link dialog so you can tell them apart.
What happens in Salesforce if I unlink a content type?
Nothing is deleted. Unlinking only stops future syncs from Contentful, including on publish. The Marketing Object and its records stay in Salesforce.
Who does the app act as in Salesforce?
The Salesforce user who clicked Connect on the configuration screen. Every sync, including sync on publish, uses that user's permissions. To change users, hover over Connected, click Disconnect, and connect again as the new user. Publishing won't sync while the app is disconnected.
Do I need to install the External Client App (ECA) again for each Contentful space?
No. The ECA is installed once per Salesforce org. Each Contentful space only needs to install the Salesforce Marketing Cloud Next Content Sync app and connect.