2.10.1 Full Integration Setup with Salesforce.

This guide walks you through creating a new Salesforce Commerce Cloud integration, from initial setup to saving your configuration, activating Websites & Stores, pulling product data, and reviewing attribute mappings. You'll learn how to fill in the required connection details (Short Code, Organization ID, Client ID/Secret), understand how the Global Pull Schedule works with UTC time, and get guidance on when to configure request delays.

Step 1: Navigate to Create Integration

1. In the sidebar menu, go to Home → Integrations.
2. Click the Create button (top right corner).
3. On the "Choose your integration" screen, select the Salesforce platform.
   
   
   
   

This opens the Create New Integration form, which consists of three steps: 1. Configuration → 2. Websites & Stores → 3. Attributes.

Step 2: Fill in the Configuration Form

Main fields:

Configuration block:

Fields marked with an asterisk () are required.*

Step 3: Global Pull Schedule

The Overwrite Global Pull Schedule toggle lets you set when product syncing should run. If disabled, the default global schedule (03:30) is used.

⚠️ Important: time is set in UTC

The Global Pull Schedule field uses UTC time, not your local timezone.

This matters especially if you have multiple Stores across different regions: a time that's off-peak (night) for one store may fall right during peak traffic hours for another. Running a data pull during peak hours can add extra load to your site and slow it down for shoppers.

Recommendation: if your Stores serve different timezones, don't rely solely on the Global Pull Schedule - override the schedule per Store (Overwrite Global Pull Schedule in that Store's settings), setting a time that matches that store's actual off-peak window, converted to UTC.

Step 4: Delay Between Pages / Delay Between Requests

The Delay between pages and Delay between requests fields set a pause (in milliseconds, range 100–15000 ms) between result pages and between individual API requests, respectively.

ℹ️ Tip: these fields are optional. If left empty, the platform's default delay is used.

We recommend not setting these values right away when first configuring the integration. Instead, run a few data pulls with the default settings and see how it goes:

• If pulls complete successfully - no further configuration is needed.
• If errors occur (e.g., rate limiting from Salesforce) - return to the integration settings and increase the delay to reduce load on the API.

Step 5: Save

Once all required fields are filled in, click Save to move on to the next step - Websites & Stores.

Step 6: Websites & Stores

After clicking Save, you're redirected to the 2. Websites & Stores tab of the integration.

✅ You'll see a success message: "Integration was created successfully. Please, do not forget to activate your Integration."

1. Activate the integration

Before you can retrieve your stores/websites, toggle Active to ON (top right of the page, in the integration status bar: Active / Authorized / REST API Connected).

2. Pull Websites and Stores

Click the PULL WEBSITES AND STORES button. This authorizes the connection to Salesforce and retrieves your available Websites and Stores.

✅ Once successful, you'll see: "Integration status has been updated" and later "Your websites and stores was pulled from integration successfully". The Authorized and REST API Connected indicators turn green (✓).

3. Activate Websites and Stores

Once pulled, you'll see a table split into Websites (Name, Code, Status) and Stores (Language, Status, Pull schedule, Products, Pull Progress, Actions).

Toggle each Website and each Store to Active, one by one.

ℹ️ Note: a star (⭐) next to a Website or Store name indicates it's the default (primary) one.

4. Pull Products

Once a Store is active, the Pull products button becomes enabled. Clicking it triggers the product data pull.

ℹ️ Note: initiating a pull actually runs 4 sequential steps, shown as individual progress bars when you expand Pull Progress (via the dropdown arrow next to the button):

1. Product Attribute
2. Category Attribute
3. Category
4. Product

Each step has its own progress bar and a ? Refresh icon to re-run that specific step individually. Every step also has a ? View logs icon to check the detailed log of that pull step.

Additionally, Category and Product steps have a ? View in catalog icon, letting you jump directly to the pulled categories/products in your catalog.

Once all 4 steps reach 100%, the main Pull Progress bar shows "Product - 100%".

Step 7: Attributes

The third and final step, Attributes, shows the list of attributes pulled from your Salesforce catalog, along with their mapping status.

Attribute mode switcher

By default, the table displays Product attributes. At the top of the table, there's a mode switcher with three options:

• Product
• Category
• Brand

⚠️ Note: for this integration, Brand attributes are not yet supported - even though it appears as an option in the switcher.

Switching between modes changes which set of attributes is displayed. For example, switching to Category shows category-specific attributes like Category ID, Description, Name, Page Description, Page Keywords, Page Title.

Table columns:

Toolbar options:

• Actions dropdown - bulk actions for selected attributes
• Store selector (e.g., Mystore: en_us (en_US)) - choose which Store to pull example data from
• Get random example data - once a Store is selected from the dropdown, this fills the Example data column with a fresh, randomly-picked sample value per attribute - useful to sanity-check the mapping
• Column visibility - show/hide table columns
• New Attribute (top right) - manually add a custom attribute not included in the default list
  
  

ℹ️ Note: the attributes shown by default are the base set provided out of the box (e.g., Brand, EAN, Long Description, Price for Product mode; Category ID, Name, Description for Category mode). If your Salesforce catalog includes custom attributes, use the New Attribute button to add and map them manually.

Step 8: Editing an Attribute

Clicking the ✏️ Edit attribute icon in the Actions column opens the Edit attribute popup, showing all details for that attribute - some fields are editable, others are read-only/system values.

Fields:

Checkboxes:

Localization

Below, per Website (e.g., Mystore) and each active locale (e.g., en_us (en_US) ??), you can enter/edit a localized value for this attribute directly — for example, overriding the Long Description text shown for that specific website/locale.

Click Save to apply changes, or Cancel to discard them.

⚠️ Caution: the Transform Data field allows runtime code execution - this is an advanced feature. Incorrect code here may break data processing for this attribute. Recommend using it only if you understand the transformation logic needed, or documenting a support-team contact if unsure.

At this point, the Salesforce integration itself is fully configured: authorized, connected, with Websites/Stores activated and product data pulled successfully.

The next steps - setting up Catalogs and building the Flow - follow the same process as with any other integration type and are covered in the general integration documentation, not specific to Salesforce.