# Connect Cin7 Core to Starshipit
URL: https://support.starshipit.com/articles/211651203-connect-cin7-core-to-starshipit
Canonical: https://support.starshipit.com/articles/211651203-connect-cin7-core-to-starshipit
Markdown: https://support.starshipit.com/articles/211651203-connect-cin7-core-to-starshipit.md
Updated: 2026-07-16

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

> Integrate your Cin7 Core platform with Starshipit to import orders and write back tracking information when you print labels.

Connect Cin7 Core and Starshipit to import orders into Starshipit or to request rates and print labels from Cin7 Core. Choose one connection direction based on where your team ships orders.

## Choose your workflow

| Workflow | Configure the connection in | Use when |
| --- | --- | --- |
| Import Cin7 Core orders into Starshipit | Starshipit | Your team manages and ships imported orders in Starshipit. |
| Request rates and print labels from Cin7 Core | Cin7 Core | Your team packs and ships sales from Cin7 Core. |

Do not configure both connection directions for the same workflow. The sections below explain the Starshipit-managed import. For the Cin7-managed shipping workflow, see [Request rates and print from Cin7 Core](#request-rates-and-print-from-cin7-core).

## Before you begin

Before getting started with Cin7 Core you will need a few things.

* Your Cin7 Core Account Id
* Your Cin7 Core API Key

If you do not have the above fields, follow the below steps:

1. Log into Cin7 Core.
2. Go to **Integration** > **Cin7 Core API** **!**
3. Click the + icon to create a new application  
4. Ensure you note down the API key that is shown in the prompt
5. On the next screen, ensure you've noted down the Account ID and then click save  
## Connect Cin7 Core to Starshipit

### To enable Cin7 Core on your account:

1. Go to **Starshipit** > **Settings** > **Integrations** > **Add a new integration** > **Cin7 Core**
2. Tick the **Enable Cin7 Core** option.
3. Recommended: Select Version 2 for the API version.
4. Enter in the **Account ID** and **Key** from Cin7 Core.
5. Click **Save**.

### Writeback

Starshipit will update your orders with carrier and tracking information when shipped. By default, Starshipit will use "DEFAULT Carrier" when updating your orders in Cin7 Core.

If you wish to have your Cin7 Core orders updated with the specific carrier name then you will need to set up Carrier Mappings in Starshipit.

1. Go to **Settings** > **Integrations** > **Cin7 Core** > **Courier Mappings**.
2. Click **Add a new mapping**.
3. From the courier drop-down, select one of your enabled couriers
4. In the courier name to use textbox, enter in the courier name you have defined in Cin7 Core
5. When done, click the tick icon.

When writeback is attempted for the courier specified, we will send back the courier name you have defined in this field

## Request rates and print from Cin7 Core

Cin7 Core also provides a direct Starshipit shipping-service integration. Use this workflow when your team requests shipping rates and prints labels from Cin7 Core instead of importing orders for processing in Starshipit.

Before requesting rates:

* Connect Starshipit from **Integrations > Starshipit** in Cin7 Core using a Starshipit API key.
* Make sure the currency and measurement units in Cin7 Core match your Starshipit account settings.
* Add valid addresses to the Cin7 Core locations you ship from.
* Add accurate weights and dimensions to products in Cin7 Core.
* In Starshipit, enable every service you want Cin7 Core to return under **Settings > Checkout Rates**.

:::important
The **Courier Mappings** under Starshipit's Cin7 Core integration control carrier names written back when Starshipit imports and ships an order. They do not make services available to Cin7 Core's **Get Shipping Rates** action. Enable those services under **Settings > Checkout Rates** instead.
:::

To request a rate in Cin7 Core:

1. Open a Simple Sale or Advanced Sale at the Quote or Order stage.
2. Add products with accurate weights and dimensions.
3. Click **Get Shipping Rates**.
4. Select **Starshipit**.
5. Select a returned carrier and service, then confirm the rate.

Cin7 Core displays the available carrier and service choices returned by Starshipit. A separate "cheapest carrier" rule is not required to compare those returned rates. If Cin7 Core passes a carrier value that must select a specific Starshipit service for label creation, configure a Starshipit rule using the **Shipping Method** condition.

For the complete Cin7-side setup and label workflow, see [Cin7 Core's Starshipit integration guide](https://help.core.cin7.com/hc/en-us/articles/9034616030095-Starshipit-Integration).

## Additional Configuration

**Status to import**: Use this option to specify what status orders should be in to import into Starshipit. You can specify multiple by separating each status with a semi-colon. For example: Ordering;Picked

**Advanced Sales**: If you are using Cin7 Core [Advanced Sales - Multiple Fulfillments](https://help.core.cin7.com/hc/en-us/articles/9034450166287-Advanced-Sales-Multiple-Fulfillment) you can configure your Starshipit integration to import each fulfilment and a single order, instead of importing the overall sales orders.
      
    To do this, you will need to be on Cin7 Core Version 2 and select "Import Sale Fulfillments instead of Sales". This means you will have multiple Starshipit orders for the one order in Cin7 Core allowing you to ship them separately with ease.

**Import Memo/Order Notes**: By default, Starshipit does not import memos from Cin7 Core. If you would like these to import into the delivery instructions field, select the option you would like from the memo drop-down. Alternatively, you can import the order notes by selecting **Import order note into delivery instructions**

**API Limits**: Cin7 Core has an API limit of 60 calls per 60 seconds. This can occasionally mean that the writeback to Cin7 Core will fail, or that the import will fail. These both will retry again should they fail.

**Use contact field as company name**: By default, Starshipit will use Customer as the contact name, however, you can use this option to use the sale.ShippingAddress.Contact field for the Starshipit receiver address company field instead.
