# Salesforce Commerce Cloud (prebuilt connector)

## Description

**Salesforce Commerce Cloud** is a cloud-based suite of products that enable eCommerce businesses to set up eCommerce sites, drive more automation and provide customers with seamless shopping experiences.

## API documentation

API documentation for Shopware (used to build this connector) can be found via the link below:

{% embed url="<https://developer.salesforce.com/docs/commerce/b2c-commerce/references/b2c-commerce-ocapi/apiexplorer.html>" %}

## Authentication&#x20;

When adding connector instances for **Salesforce Commerce Cloud**, the following authentication methods are supported:

* [OAuth 2 (client credentials)](#oauth-2-authorisation-code)

### OAuth 2 (client credentials)

When a user chooses to [add a connector instance](https://doc.wearepatchworks.com/product-documentation/connectors-and-instances/working-with-instances/adding-an-instance) using **OAuth 2 (client credentials)** authentication, the credentials below are prompted:

<table><thead><tr><th>Credential</th><th data-type="checkbox">Required?</th><th>Notes</th></tr></thead><tbody><tr><td>Version</td><td>true</td><td>Set to <code>v1</code></td></tr><tr><td><code>Scope</code></td><td>true</td><td>The required scope to define what access permissions should be given to Patchworks. Scopes should be entered in the form: <br><code>SALESFORCE_COMMERCE_API:{{realmid}}_{{instanceid}} {{scope 1}} {{scope 2}} {scope etc}}</code>. For example:<br><code>SALESFORCE_COMMERCE_API:zzhl_002 sfcc.catalogs sfcc.cdn-zones sfcc.customerlists</code>. For a list of valid scopes please see <a href="https://developer.salesforce.com/docs/commerce/commerce-api/guide/auth-z-scope-catalog.html?q=scopes">this Salesforce page</a>.</td></tr><tr><td><code>Client ID</code></td><td>true</td><td>Enter the API client ID that was generated when you created an API client for Patchworks in Salesforce. For more information about generating your API client credentials please see <a href="https://developer.salesforce.com/docs/commerce/commerce-api/guide/authorization-for-admin-apis.html">this Salesforce guide</a>.</td></tr><tr><td><code>Client Secret</code></td><td>true</td><td>Enter your Salesforce Cloud Commerce account password.</td></tr><tr><td><code>Short Code</code></td><td>true</td><td>This is an eight-character string that you can find in Salesforce Business Manager. For guidance, please see <a href="https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#short-code">this Salesforce guide</a>.</td></tr><tr><td><code>Organization ID</code></td><td>true</td><td>Each Salesforce B2C Commerce instance has its own unique organization ID, which you can find in Salesforce Business Manager. For guidance, please see <a href="https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#organization-id">this Salesforce guide</a>.</td></tr></tbody></table>