# How to connect to Magento

To create a connection with Magento, you need to create an 'Integration' by completing the following steps.

Note: This looks like a lot of steps, but they are all quite simple and we're providing screenshots of each to make it as clear as possible.

## Creating a new Magento Integration

1. After you've signed in as an Admin, from the left menu, select **System > Extensions > Integrations**.

![Magento: Step 1](https://res.cloudinary.com/apideck/image/upload/v1716384710/docs/connectors/magento/step-1-nav.png)

2. Select **Add New Integration**.

![Magento: Step 2](https://res.cloudinary.com/apideck/image/upload/v1716384711/docs/connectors/magento/step-2-integrations.png)

3. Enter a _Name_ and _Email_ for the integration and enter your admin password. **Note: The callback and identity URL should be left blank.**

![Magento: Step 3](https://res.cloudinary.com/apideck/image/upload/v1716384712/docs/connectors/magento/step-3-new-integration.png)

4. _Before_ clicking **Save**, you'll need to select **Basic Settings > API** to configure the integration permissions. From this view you'll need to ensure that the following permissions are selected:

- Sales
- Catalog
- Customers

These permissions are required to pull `Order` and `Customer` data from Magento.

![Magento: Step 4](https://res.cloudinary.com/apideck/image/upload/v1716384712/docs/connectors/magento/step-4-permissions.png)

5. Now that your integration has been created, it needs to be **Activated** by clicking the `Activate` link in the table.

![Magento: Step 5](https://res.cloudinary.com/apideck/image/upload/v1716384713/docs/connectors/magento/step-5-activate.png)

6. Enable permissions by review the permissions you've assigned and click **Allow**.

![Magento: Step 6](https://res.cloudinary.com/apideck/image/upload/v1716384713/docs/connectors/magento/step-6-allow.png)

7. Now that your integration has been Activated, you'll be presented with the **Consumer Key**, **Consumer Secret**, **Access Token**, and **Access Token Secret**. These are the credentials you'll use to connect to Magento.

![Magento: Step 7](https://res.cloudinary.com/apideck/image/upload/v1716384713/docs/connectors/magento/step-7-tokens.png)

## Vault Connection Setup

Now that you've created the Integration setup with access to your Magento data, you can fill out your credentials in Vault.

Add a Shop Name and the domain that hosts your Rest API. Please note, the domain should not include the /rest/V1/ suffix as this is added automatically.

Then add each of the tokens provided by Magento to their respective fields.

![Vault Magento Tokens](https://res.cloudinary.com/apideck/image/upload/v1716384714/docs/connectors/magento/step-8-connection.png)

Click **Save** after completing the form. If the all fields are correctly entered, it will validate the connection credentials and indicate it is now **connected**.

![Vault Magento Connected](https://res.cloudinary.com/apideck/image/upload/v1716384715/docs/connectors/magento/step-9-connected.png)

Your Magento Integration is now connected 🎉.