# Connect Magento 1 to Starshipit
URL: https://support.starshipit.com/articles/203826179-connect-magento-1-to-starshipit
Canonical: https://support.starshipit.com/articles/203826179-connect-magento-1-to-starshipit
Markdown: https://support.starshipit.com/articles/203826179-connect-magento-1-to-starshipit.md
Updated: 2026-05-06

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

> Learn how to integrate your Magento 1 platform with Starshipit.

## Before you begin

You can have more than one Magento store integrated with Starshipit if the stores are under the same Magento account in the Admin panel. If they are in separate Magento accounts, you'll need to set it up as a child account.

## 1. Create a role and user in Magento 1

Set up an API access, and create a Webservice role and assign it to a Webservice role in Magento.

#### Create a new role

1. Go to your Magento Admin Dashboard.
2. From the **System** menu, select **Web Services**, then select **SOAP/XML-RPC - Roles**.
3. From the roles page, click **Add New Role**.
4. Enter a role name, and then click **Role Resources**.
5. Set the **Resource Access** to **ALL**.
6. In the top right-hand of the screen, click **Save Role**.

#### Assign your new role to a user

1. Go to your Magento Admin Dashboard.
2. From the **System** menu, select **Web Services**, then select **SOAP/XML-RPC - User**.
3. From the users page, click **Add new User**.
4. Enter the account information as required.  
   Note that the API Key will work as the password you enter in Starshipit. You can set this accordingly.
5. Set the account to **Active**.
6. On the **User Information** panel, click **User Role**. Assign the user your previously created the role for.  

## 2. Enter your Magento 1 details in Starshipit

After you have created the user and the role in Magento, you need to add the URL, username and the password in Starshipit. You can customise the status of orders to import, however the default status "processing" should be correct for most Magento stores.

1. In Starshipit, navigate to **Settings** > **Integrations**.
2. Click **Add a new integration** and select **Magento**.
3. Enter the URL of your site e.g. http://www.mysite.com/api/xmlrpc or http://www.mysite.com/index.php/api/xmlrpc.
4. Enter your Magento username and password. The password is the API Key that you created in Magento.
5. Click **Save**, then test your connection using the **Test to ensure it works** button.

## (Optional) Disable email notifications in Magento

1. Log in to your Magento account.
2. From the **System** menu, select **Configuration**.
3. Under the **Advanced** tab, select the **System** menu item.
4. Select **Mail Sending Settings**.
5. Set **Disable Email Communications** to ‘**Yes**’.  
   Emails will no longer be sent through Magento.

## Delivery instructions

The following fields are imported for Delivery Instructions:

* myOrderInfo.shipping_address.special_delivery_info
* myOrderInfo.special_delivery_info
* myOrderInfo.shipping_address.customer_comments
* myOrderInfo.customer_note
* myOrderInfo.onestepcheckout_customercomment

## Configure Magento 1 settings

Complete these connection and import controls during setup. You can update them later from **Settings > Integrations > Magento 1**:

| Setting | What it controls |
| --- | --- |
| **Enable Magento1** | Turns the Magento 1 connection on or off. |
| **URL** | The Magento API endpoint, usually ending in `/api/xmlrpc` or `/index.php/api/xmlrpc`. |
| **User Name** | The Magento web-service user name. |
| **API Key** | The API key/password for the Magento web-service user. |
| **Network User Name** | Optional network-level authentication user name when your Magento host requires it. |
| **Network API Key** | Optional network-level authentication key. |
| **User Agent** | Optional value sent to Magento to identify Starshipit requests. |
| **Import Hours** | Limits the age of orders considered during an import. |
| **Import Status** | Limits imports to orders with the status you enter. |
| **Sync complete and cancelled** | Includes complete and cancelled Magento orders in synchronisation. |
| **Import on search** | Allows a search to retrieve an order from Magento when it is not already imported. |
| **Enable writeback** | Sends tracking and shipment updates back to Magento. |

Click **Save** after changing settings, then use **Test connection** to verify the connection.