Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.remark.ai/llms.txt

Use this file to discover all available pages before exploring further.

This guide walks your team through the setup steps required for Remark to integrate with your Salesforce Commerce Cloud (SFCC) instance. The work is split across three areas: provisioning an API client for SCAPI Admin APIs, sharing a few configuration values from your instance, and granting Remark team members the access they need to both Business Manager and the Shopper API. Each section is self-contained, and we’ve kept the steps tightly scoped to what Remark needs. You should be able to complete everything in a single sitting; if anything is unclear or you hit a snag, your Remark contact is available to help at any time.

​
Overview

At a high level, Remark needs three things to integrate with your SFCC instance:
  1. An API client configured with a specific set of scopes, so Remark can read catalog, inventory, order, product, and promotion data through the SCAPI Admin APIs.
  2. Two configuration values — your SHORT_CODE and ORGANIZATION_ID — which Remark uses alongside the API client credentials.
  3. User access for two Remark team members, both to your Business Manager and as SLAS Organization Administrators on the Shopper API (production and staging).
The Shopper API access in step 3 is needed because we’ve found that certain data — product pricing in particular — isn’t reliably available through the SCAPI Admin APIs alone, despite what Salesforce’s documentation suggests. Granting SLAS access lets us work around this on our side without further involvement from your team.

​
1. Create an API client for SCAPI Admin APIs

Follow Salesforce’s official instructions for creating an API client in Account Manager. Only the “Create an API Client” section applies to this step — Remark will handle the remaining configuration on our side.

Authorization for SCAPI Admin APIs

Salesforce’s official guide for creating an API client in Account Manager.
When configuring the client, please add the following scopes to the Allowed Scopes field:
  • sfcc.catalogs
  • sfcc.inventory.availability
  • sfcc.inventory.impex-inventory
  • sfcc.inventory.reservations
  • sfcc.orders
  • sfcc.products
  • sfcc.promotions
These scopes are read-oriented and grant Remark the permissions needed to serve your shoppers and customers. Once the client is created, please share the client ID and secret with your Remark contact through a secure channel.

​
2. Share your SHORT_CODE and ORGANIZATION_ID

To finish wiring up the API client, Remark needs the SHORT_CODE and ORGANIZATION_ID for your SFCC instance. Salesforce documents where to find both values here:

Where to find ORGANIZATION_ID and SHORT_CODE

Salesforce’s getting-started guide covers where to locate both values.
Please send these along with the API client credentials from the previous step.

​
3. Create Business Manager accounts

Please create Business Manager user accounts for the Remark team members who will work on the integration. Your Remark contact will supply the email addresses (and any other details required) for the accounts to be created.

​
4. Grant SLAS Organization Administrator access (Shopper API)

In addition to Business Manager access, please grant the same accounts the SLAS Organization Administrator role on both your production and staging environments. This unlocks the Shopper API access needed to retrieve data — pricing in particular — that isn’t consistently exposed via the SCAPI Admin APIs. Salesforce’s documentation covers this; only the “SLAS Admin UI: Set Up User Roles and Filters” section applies.

SLAS Admin UI: Set Up User Roles and Filters

Salesforce’s guide to assigning SLAS roles in the Admin UI.
Grant SLAS access to the same accounts created in step 3.

​
What to send back to Remark

Once the steps above are complete, please share the following with your Remark contact through a secure channel. We recommend a password manager share or an encrypted message — please don’t email credentials in plaintext.
  • API client ID
  • API client secret
  • SHORT_CODE
  • ORGANIZATION_ID
  • Confirmation that Business Manager accounts have been created
  • Confirmation that SLAS Organization Administrator access has been granted on production and staging

​
Next steps

Once Remark has API access and Business Manager accounts in hand, we’ll begin validating the connection and assessing the data available against your specific configuration. From there, we’ll be able to give you a clearer picture of where (if anywhere) we’ll need developer support from your team to complete the integration.

​
Questions or issues

Your Remark contact is available around the clock during onboarding. If anything in this guide is ambiguous, if a Salesforce step doesn’t match what you’re seeing in your console, or if you’d prefer to walk through any of this on a call, please reach out — we’d rather pause and clarify than make you guess.