---
title: "How to connect a courier"
description: "The general steps to add any courier in ShipDock, what the card states mean, which plan you need and how to fix the most common errors."
url: https://help.shipdockapp.eu/en/articles/11764762-how-to-connect-a-courier
collection: "Couriers"
updated: 2026-11-19
language: en
---

# How to connect a courier

The general steps to add any courier in ShipDock, what the card states mean, which plan you need and how to fix the most common errors.

These steps are the same for every courier in ShipDock. Fields that only one courier has are in its own guide: see [Supported couriers and what each one can do](https://help.shipdockapp.eu/en/articles/11764763.md).

## Before you start

-   You need your own contract with the courier and its API login details. ShipDock does not resell shipping.
    
-   **Lite** plan: add couriers, show pickup points, set up shipping rates. Free or no subscription: you cannot add couriers.
    
-   **Full** and **Full Shopify Plus**: also creating labels through the courier and the automatic label switches.
    

## Add the courier

1.  Open **Providers** and click **Create provider**, or click **Add a carrier** on the ShipDock home page.
    
2.  In the country selector, choose the country you ship your parcels from.
    
3.  Click the button on the courier's card. Its **General** tab opens.
    

What the button on the card means:

-   **Select**: the courier is live.
    
-   **Use in BETA**: a new integration. Double-check labels, COD and shipping details on your first shipments.
    
-   **Request BETA access**: send the form. After ShipDock support turns the courier on, the button changes to **Use in BETA**.
    
-   **In progress - Notify me**: cannot be added yet. The form lets us tell you when it is ready.
    
-   **Used**: you already added this card. Each card can be added once per store.
    

Courier not on the page? Click **Let us know which carrier you need** in the **Missing a carrier?** banner.

## Turn on the connection

1.  On the **General** tab, in the **Connection** card, turn on **Connect provider throught API**.
    
2.  If the card shows **Connection mode**, keep **Production**. Choose **Sandbox / Development** only with the courier's test login details.
    
3.  Enter the login details from the courier. The field names differ per courier.
    
4.  In **Sender details**, fill in the sender address and contact printed on the label.
    
5.  Optional: in **COD Details**, fill in the bank account for cash on delivery payments.
    
6.  In the **Status** panel, choose **Active** and click **Save**.
    

> **Important:** In **Sandbox / Development** labels go to the courier's test system and parcels are not picked up. Switch back to **Production** before you ship real orders.

**Sender details** and **COD Details** usually appear only after you turn the connection on. With some couriers, for example Packeta and DHL Express, the other tabs stay locked until the required fields are filled.

## Set up rates and automatic labels

On the courier's **Pickup points** and **Home delivery** tabs, under **Choose integration**, pick how the rates reach your checkout:

-   **Manual rates mapping**: you create the rates in Shopify and select them in **Shipping rates mapping**.
    
-   **CCS - Dynamic Rates**: you create the rates and prices in ShipDock.
    
-   **CCS - Nearest Pickup Points** (Pickup points tab only): the nearest pickup points appear in checkout as shipping options.
    

Both CCS options need carrier-calculated shipping on your Shopify plan. The full steps are in [How to set up shipping rates](https://help.shipdockapp.eu/en/articles/11764754.md).

Each tab also has two switches under **General settings**. They work only on the Full plan:

-   **Automatically generate shipping labels (Order Fulfilled)**
    
-   **Automatically generate shipping labels (Order Created)**
    

The **Summary** panel shows **All set** or **Needs setup** and names the missing part.

## Limits

-   A courier with a card per country, for example DPD or GLS: add one card per ship-from country.
    
-   **Connection mode** exists only for PPL, GLS, DPD BE, Omniva, Orlen Paczka, Slovenská pošta and DHL Express.
    

## Troubleshooting

-   **I can't click Create provider or Select.** Your store has no paid plan. Click **Go to subscriptions** in the banner.
    
-   **I don't see my courier.** Check the country selector: cards are listed by ship-from country.
    
-   **"Provider connection is disabled. Please activate API connection with credentials in the provider detail."** Turn on **Connect provider throught API** on the **General** tab and save.
    
-   **Authentication error when creating a label.** Check the login details for extra spaces and that **Connection mode** matches them.
    
-   **"Shopify Shipping Rate (...) in order not assigned in Shipping settings."** Map the rate on the courier's **Pickup points** or **Home delivery** tab.
    
-   **"Pickup Point is missing. The user probably did not select it."** Set the pickup point on the order in ShipDock, then create the label.
    
-   **"... You have to set COD value to 0 or mark order as Paid."** This courier does not accept this COD order. See [Supported couriers](https://help.shipdockapp.eu/en/articles/11764763.md).
    
-   **The label buttons in Orders show a lock.** Creating labels needs the Full plan.
    

## Related articles

-   [Supported couriers and what each one can do](https://help.shipdockapp.eu/en/articles/11764763.md)
    
-   [How to set up shipping rates](https://help.shipdockapp.eu/en/articles/11764754.md)
    
-   [How to set up cash on delivery (COD)](https://help.shipdockapp.eu/en/articles/9579888.md)

## Related

- [Supported couriers and what each one can do](https://help.shipdockapp.eu/en/articles/11764763-supported-couriers-and-what-each-one-can-do.md)
- [How to connect Balíkovna and Česká pošta](https://help.shipdockapp.eu/en/articles/11764744-how-to-connect-balikovna-and-ceska-posta.md)
- [How to connect BoxNow](https://help.shipdockapp.eu/en/articles/11764755-how-to-connect-boxnow.md)
- [How to connect DHL Express](https://help.shipdockapp.eu/en/articles/11764765-how-to-connect-dhl-express.md)
- [How to ship with DHL Express outside the EU from Shopify](https://help.shipdockapp.eu/en/articles/11764790-how-to-ship-with-dhl-express-outside-the-eu-from-shopify.md)
