# Finding service connector credentials for CommerceTools

## Required credentials

To [add a Patchworks connector](https://doc.wearepatchworks.com/product-documentation/patchworks-services/service-connectors/adding-a-service-connector) for **CommerceTools**, the following details are required for authentication:

<table><thead><tr><th>Credential</th><th data-type="checkbox">Required</th><th>Note</th></tr></thead><tbody><tr><td><a href="#obtaining-credentials">project_key</a></td><td>true</td><td>Available when a <a href="#obtaining-credentials">new API client </a>is created in the CommerceTools dashboard.</td></tr><tr><td><a href="#obtaining-credentials">client_id</a></td><td>true</td><td>As above</td></tr><tr><td><a href="#obtaining-credentials">secret</a></td><td>true</td><td>As above</td></tr><tr><td><a href="#obtaining-credentials">scope</a></td><td>true</td><td>As above</td></tr><tr><td><a href="#obtaining-credentials">API URL</a></td><td>true</td><td>As above</td></tr><tr><td><a href="#obtaining-required-information">Auth URL</a></td><td>true</td><td>As above</td></tr></tbody></table>

## Obtaining credentials

The credentials listed above are needed so that Patchworks can access the required data in **CommerceTools**. To obtain these details, follow the steps below to create a new **API client**.

**Step 1**\
In your browser, open the URL that you use to access the **CommerceTools** dashboard.

**Step 2**\
From **settings**, select **developer settings**:

![](https://content.gitbook.com/content/5mpqoXPMbUuPa8JpCLWe/blobs/KVC3vzvrlgJfuFSvF6po/commercetools%20dev%20settings.png)

**Step 3**\
Click the **create new api client** button:

![](https://content.gitbook.com/content/5mpqoXPMbUuPa8JpCLWe/blobs/MNpcxoskbJ4tBTMKVH86/commercetools%20create%20new%20api.png)

**Step 4**\
Select the following scopes:

| Manage   | View                            | Manage My | Tokens |
| -------- | ------------------------------- | --------- | ------ |
| Orders   | Customer groups                 | Orders    | N/A    |
| Products | Customers                       |           |        |
|          | Discount codes                  |           |        |
|          | Orders \[default]               |           |        |
|          | Payments                        |           |        |
|          | Products (all) \[default]       |           |        |
|          | Products (published) \[default] |           |        |
|          | Shipping methods                |           |        |
|          | States                          |           |        |
|          | Stores                          |           |        |
|          | Types                           |           |        |

You can see the required selections below:

<div align="left"><img src="https://content.gitbook.com/content/5mpqoXPMbUuPa8JpCLWe/blobs/gB5fyj4fAnDFscXAbAaX/commercetools_api_client_scopes.png" alt=""></div>

**Step 5**\
Click the **create api client** button:

<div align="left"><img src="https://content.gitbook.com/content/5mpqoXPMbUuPa8JpCLWe/blobs/C00imfanvswGkeaM0H1T/commercetools_create_api_client.png" alt=""></div>

**Step 6**\
All required authentication details are displayed - add them to your password manager immediately as they are only shown once. &#x20;