Skip to main content
Instabox (Legacy API) is the older way to connect Instabox. It is marked Deprecated on the All carriers tab. Hover over the badge to read: “The standalone Instabox API is deprecated. Migrate to the Instabee-powered Instabox integration.” Use it only if you still have carrier credentials for the older Instabox system (a client ID and secret). For a new setup, use Connect Instabox instead. The fields that every carrier shares are on Carrier credentials.
Existing connections keep working: you can still connect this carrier and send shipments with it. New setups should use Instabox.
You do not pick a sender address on this form. Add your addresses under the organization menu → Manage → Addresses. You choose the sender address on each shipment or in a shipping rule.

Before you start

You need three details from Instabox for the older system:
  • your Client ID
  • your Client secret
  • your Customer number, the prefix Instabox puts on your parcel numbers (for example PA02)
These are not the same as the single API key used on Connect Instabox. Learn more on the card opens instabee.com.

Connect Instabox (Legacy API)

1

Open All carriers

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

Find the right card

Find the card named Instabox (Legacy API) with the yellow Deprecated badge. It is a different card from Instabox. Click Connect.
3

Fill in the form

The Connect carrier window opens. Enter a Carrier name, then Client ID, Client secret and Customer number. Test mode is under Optional fields.
4

Connect the carrier

Click Connect. You see “Carrier connected”, and the carrier appears on the My carriers tab.
All carriers tab with the Instabox Legacy API card marked Deprecated, with Connect and Learn more buttonsAll carriers tab with the Instabox Legacy API card marked Deprecated, with Connect and Learn more buttons

The Instabox (Legacy API) card with the Deprecated badge

Connect carrier window for Instabox Legacy API with Client ID, Client secret and Customer numberConnect carrier window for Instabox Legacy API with Client ID, Client secret and Customer number

Enter Client ID, Client secret and Customer number

Instabox Legacy API form scrolled to Optional fields with the Test mode checkboxInstabox Legacy API form scrolled to Optional fields with the Test mode checkbox

Test mode is under Optional fields

Fields on the form

Connect does nothing until Carrier name, Client ID, Client secret and Customer number all have a value.

Test or live

For this older connection, Instabox decides between its test system and real shipments from the credentials you enter, not from the Test mode checkbox. Test credentials from Instabox create test shipments. Live credentials create real shipments, even with Test mode on. To try things out, ask Instabox for test credentials and turn on Test mode while you use them. See Test mode.

After you connect

The carrier appears on My carriers with a Connected badge. When you pick it on a shipment, it also shows the Deprecated badge. You choose the product on each shipment or in a shipping rule, not on this form. See Carrier products and services. Products are usually used within and between Sweden, Norway, Denmark, Finland and the Netherlands, from 0.1 to 20 kg. You can choose other countries on a shipping rule. Instabox accepts or rejects the shipment when you send it.
  • Locker delivery needs a service point (here, a locker) before you can send. See Pick a service point.
  • Zippendo checks with Instabox every hour for 21 days after you send, so you see where the parcel is. These checks never show that a parcel was delivered. Only Instabee’s own tracking updates do, and Instabee turns them on once you send it the details under Tracking webhook on Edit carrier. See Turn on tracking for Instabox, Budbee and Porterbuddy on Carrier tracking webhooks.
  • Instabox does not create customs documents. If the shipping rule has Generate proforma invoice or Generate commercial invoice turned on, Zippendo creates that document. See Customs and documents.
  • This carrier is not available under Pickups.

Change or remove the connection

To change it, open Carriers → My carriers and click Edit carrier on the card. The Edit carrier page has two sections:
  • General: Carrier name, and Brand if your organization has brands.
  • Carrier settings: Client ID, Client secret, Customer number and Test mode.
Click Save. You see “Carrier updated”. To remove it, click Delete on the same page, type the carrier name in capital letters, and click Delete. Shipping rules that use this carrier are deleted with it. Shipments you already sent keep their labels and tracking numbers. When you move to the new connection, first connect Instabox, update your shipping rules to use it, and then delete this legacy connection.

Common problems