# Finding service connector credentials for Magento 2

## Required credentials

To [add a Patchworks connector](https://doc.wearepatchworks.com/product-documentation/patchworks-services/service-connectors/adding-a-service-connector) for **Magento 2**, 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="#token">Token</a></td><td>true</td><td>Displayed immediately after <a href="#token">creating a new integration in the Magento admin console</a>.</td></tr><tr><td><a href="#url">URL</a></td><td>true</td><td>The first part of <a href="#url">the URL that you use to access the Magento admin console</a>.</td></tr></tbody></table>

## Obtaining credentials

The credentials listed above are needed so that Patchworks can access the required data in **Magento 2**. To obtain these details, follow the steps below.

### Token

To obtain the token (actually an **access token**) required for Patchworks to access your **Magento 2** data, you must create an **integration**. To do this, follow the steps below.

**Step 1**\
Log into your **Magento admin console**.

**Step2** \
Click on the **system** button with a cog icon to open the menu:

![](https://content.gitbook.com/content/5mpqoXPMbUuPa8JpCLWe/blobs/O44tJrS0AuTtWUBtcFrQ/image.png)

**Step 3**\
Click on **integrations** under the **extensions** header. This will load the following page:&#x20;

![](https://content.gitbook.com/content/5mpqoXPMbUuPa8JpCLWe/blobs/Y5NcZWzDMaYvaJZ5TyJJ/image.png)

**Step 4**\
Click on **add new integration** to start adding a new integration.

**Step 5**\
Provide the required information in the first form. We suggest setting the name as 'Patchworks':

![](https://content.gitbook.com/content/5mpqoXPMbUuPa8JpCLWe/blobs/cUt26jjgVRkN32yxkaor/image.png)

**Step 6**\
Click **API** under **basic settings** and assign the required permissions:

![](https://content.gitbook.com/content/5mpqoXPMbUuPa8JpCLWe/blobs/dUCDouIyXwpRpVtAfNny/image.png)

**Step 7**\
Click **save**. You will then be taken to the below page:

&#x20;![](https://content.gitbook.com/content/5mpqoXPMbUuPa8JpCLWe/blobs/Ef32YRcmQINfgMBL6nx5/image.png)

**Step 8**\
Click **activate** for the integration you just saved and when prompted, confirm that the permissions are correct:

![](https://content.gitbook.com/content/5mpqoXPMbUuPa8JpCLWe/blobs/dSpbJcTVoyjlkdvAvGKa/image.png)

**Step 9**\
Click **allow** to display integration tokens - add them all to your password manager, ready for use in your Patchworks setup:

![](https://content.gitbook.com/content/5mpqoXPMbUuPa8JpCLWe/blobs/vvn4xyxSbnHPpQAW7tDS/image.png)

{% hint style="info" %}
The **access token** is required for Patchworks, but it's worth logging all token information returned here. &#x20;
{% endhint %}

### URL

To find the URL required to add a Patchworks connector, log into your **Magento 2** **admin console** and check the URL in your browser's address bar. You need everything up to and including 'magento.com' - for example:

```
https://www.acme-magento.com/
```