# 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](/product-documentation/connectors-and-instances/working-with-instances/adding-an-instance.md) 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.wearepatchworks.com/product-documentation/connectors-and-instances/patchworks-connectors/salesforce-commerce-cloud-prebuilt-connector.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.