Connect Instabox

Connect Instabox to send parcels to Instabox lockers and to your customers’ homes in Sweden, Norway, Denmark and Finland. Instabox is part of Instabee, and Zippendo connects to it with one Instabee API key. On All carriers, use the card named Instabox. The card named Instabox (Legacy API) is an older connection that is being phased out: see Connect Instabox (Legacy API). This page covers Instabox only. The fields every carrier shares are on Carrier credentials. Walkthrough: Carriers.

What you need from Instabox

An Instabox shipping agreement.
An Instabee Integration API key for that agreement. Instabee gives you the key. Zippendo cannot create it for you.

Open All carriers

In the sidebar, click Carriers, then the All carriers tab.

Click Connect on Instabox

Find the card named Instabox, without “Legacy API” and without a Deprecated badge, and click Connect. (Learn more opens instabee.com.)

Fill in the form

The Connect carrier window opens. Carrier name is already filled in with “Instabox”. Paste your key into API key. Test mode is under Optional fields.

Click Connect in the window

You see Carrier connected. Instabox now appears on My carriers marked Connected.

All carriers with the Instabox card and its Connect and Learn more buttons — The Instabox card on All carriers

Connect carrier window for Instabox with the required API key and the optional Test mode — Connect carrier for Instabox - API key and Test mode

What to enter

Field	Required	Description in the form	What to enter
Carrier name	Yes		The name you see in Zippendo. Keep “Instabox” or change it.
Brand	No	Only this brand can use this carrier.	Shown only if your organization has brands.
API key	Yes	Your Instabee Integration API key (sent as ‘Authorization: ApiKey <key>‘)	The key exactly as Instabee gave it to you.
Test mode	No	Use Instabee’s test environment	Leave it off for real shipments. See below.

There is no client ID, client secret or customer number on this form. Those belong to Instabox (Legacy API).

Test or live

With Test mode on, Zippendo sends your shipments to Instabee’s test system instead of the real one. You use the same API key. Turn it off before you ship real orders. More in Test mode.

After you connect

You choose an Instabox product when you create a shipment or a shipping rule. See Carrier products and services. Each parcel can weigh 0.1 to 20 kg.

Product	Use it for	Choose a locker?
Locker delivery	Sending to an Instabox locker	Yes
Home delivery	Sending to the receiver’s home. Instabox plans the delivery time.	No
Locker return (return shipment)	Your customer drops the return at a locker. Optional service: Labelless	Yes

Instabox has no home return product.

Lockers: for Locker delivery and Locker return, choose the locker in the Service point section of the shipment before you send. See Pick a service point.
Pickups: Instabox is not available under Pickups.
Tracking: tracking updates come from Instabee once it has turned them on for your account. Send Instabee the details under Tracking webhook on Edit carrier. See Turn on tracking for Instabox, Budbee and Porterbuddy on Carrier tracking webhooks.
Customs: Instabox does not create customs documents in Zippendo.

If the connection fails

Zippendo saves your key without checking it. A mistake shows up the first time you send a shipment.

What you see	What to do
Nothing happens when you click Connect	Fill in Carrier name and API key.
You’ve reached your plan’s limit. Upgrade your plan or remove something you no longer use.	Your plan’s carrier limit is reached. Upgrade or delete a carrier you no longer use (Billing and usage).
The carrier rejected your login details. Update the carrier credentials under Carriers.	Paste the key again without extra spaces. If you copied it from the legacy Instabox setup, ask Instabee for an Instabee Integration API key.
This product delivers to a service point. Select a service point before sending.	Choose a locker on the shipment.
The selected carrier product does not ship between these countries. Choose a different product.	Instabox ships only within Sweden, Norway, Denmark and Finland.
The connection to the carrier was lost before it answered. Zippendo has no confirmation that the shipment was created, so check with the carrier before sending again.	Check with Instabox whether the shipment exists before you send it again.

More help: Carrier authentication failures.

Change or remove the connection

Change: on My carriers, click Edit carrier. Update the fields under Carrier settings and click Save.
Remove: on the same page, click Delete, type the carrier name in capital letters (for example INSTABOX) and click Delete. Shipping rules that use this carrier are deleted too. Shipments you already sent keep their labels and tracking numbers.

Overview

Shipments

Orders & channels

Carriers

Connect a carrier

Connect an integration

Printing

Automation

Account

Search & dashboard

API & events

Connect Instabox

What you need from Instabox