# Connect Adobe Commerce (Magento 2) to Starshipit
URL: https://support.starshipit.com/articles/213430403-connect-adobe-commerce-magento-2-to-starshipit
Canonical: https://support.starshipit.com/articles/213430403-connect-adobe-commerce-magento-2-to-starshipit
Markdown: https://support.starshipit.com/articles/213430403-connect-adobe-commerce-magento-2-to-starshipit.md
Updated: 2026-09-03

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Integrate your Adobe Commerce (previously Magento) platform with Starshipit using token or user authentication to import orders and write back tracking information.

Integrate your Adobe Commerce platform (previously Magento) with Starshipit using token or user authentication to import orders and write back tracking information.

:::important
Adobe Commerce 2.4 uses two-factor authentication by default, so use **Token** authentication. In Adobe Commerce 2.4.4, also allow OAuth access tokens to be used as standalone bearer tokens under **Stores > Configuration > Services > OAuth > Consumer Settings**.
:::

## Before you begin

You need your Adobe Commerce store URL and an authentication method. **Token** authentication is recommended.

## Create an access token

1. In Adobe Commerce, go to **System > Extensions > Integrations**.
2. Click **Add New Integration** and enter `Starshipit` as the name.
3. Enter your Adobe Commerce admin password, then open the **API** tab.
4. Under **Resource Access**, select **All**, then click **Save**.
5. Back on the Integrations page, click **Activate** for Starshipit and then **Allow**.
6. Copy the **Access Token** from the confirmation dialog. You do not need the consumer key, consumer secret, or access-token secret.

## Connect Adobe Commerce in Starshipit

1. Go to **Settings > Integrations > Add a new integration > Adobe Commerce**.
2. Turn on **Enable Adobe Commerce**.
3. Select **Token** authentication and enter your store URL and access token.
4. Choose the order status or statuses to import. Separate multiple statuses with a semicolon.
5. Click **Save**, then use **Test connection** and confirm a test order imports as expected.

<!-- faq:start -->

<!-- faq:question -->Can I use user authentication instead?<!-- /faq:question -->

Yes. In Adobe Commerce, create an **Integration** user role with **All** resource access. Create a user, assign that role, then enter the username and password in Starshipit. Use token authentication when possible.

<!-- faq:end -->

## Optional order fields

To offer delivery instructions, authority to leave, or signature-required choices at checkout, create these Adobe Commerce custom fields:

```
delivery_comment (String max 100) for the delivery instruction  
authority_to_leave: values can be 0, 1, true, false, yes or no  
signature_required: values can be 0, 1, true, false, yes or no  
```
:::note
Add these fields to the `/rest/V1/orders/` order-search criteria API.
:::

Turn on **Import bundle items** only when you need bundle lines to import. Bundle details appear on customised packing slips; ship-together bundles are not supported.

## Configure Adobe Commerce settings

Complete the following fields when you connect Adobe Commerce (Magento 2). You can update them later from **Settings > Integrations > Adobe Commerce (Magento 2)**.

| Setting | What it controls |
| --- | --- |
| **Enable Magento2** | Turns the connection on or off. |
| **Authentication** | Choose **User** authentication or **Token** authentication. Token authentication is recommended for Adobe Commerce 2.4. |
| **Store URL** | The base URL of your Adobe Commerce store. |
| **Access Token** | The token used for Token authentication. |
| **Username** and **Password** | Credentials used for User authentication. |
| **User Agent** | Optional value sent to Adobe Commerce to identify Starshipit requests. |
| **Status** | Selects the Adobe Commerce order status to import. |
| **Disable writeback** | Stops Starshipit from sending shipment and tracking updates back to Adobe Commerce. |
| **Use base currency value fields** | Uses Adobe Commerce base-currency values when importing order amounts. |
| **Map address line 2 to building field** | Maps address line 2 into Starshipit's Building field. |
| **Import bundle items** | Imports bundle items. Bundle details are available on customised packing slips; ship-together bundles are not supported. |
| **Unit of Measurement** | Selects the unit used when importing product dimensions. |

Click **Save** after changing settings. Use **Test connection** to verify the connection and confirm that a test order imports with the expected status.