Skip to main content
Instabox (Legacy API) is the standalone Instabox OAuth integration. It is marked Deprecated on All Carriers. The catalog card copy is: Legacy Instabox API integration for locker and home delivery across the Nordics. Deprecated — migrate to the Instabee-powered Instabox integration. Prefer Connect Instabox (catalog slug instabox) unless you still have OAuth credentials for this older API. This page documents the live Connect form for slug instabox_legacy. Shared chrome: Carrier credentials. Inventory: Connect a carrier or integration. Walkthrough: Carriers.
The badge on the card is Deprecated. Tooltip: The standalone Instabox API is deprecated. Migrate to the Instabee-powered Instabox integration. You can still Connect and book with stored credentials. New setups should use Instabox.
You do not pick a sender address on this form. Add addresses under Manage → Addresses. The address is chosen on the shipment or on a shipping rule.

​
Prerequisites

  • Existing Instabox OAuth credentials from the standalone Instabox API (not the current Instabox API Key form).
  • Client ID, Client Secret, and Customer Number (parcel id prefix, for example PA02) — those names are the helpers on the form.
  • Learn more opens instabee.com.

​
Connect from All Carriers

1

Open All Carriers

Sidebar Carriers. Page title Carriers / Integrations. Header tabs: My Carriers (?tab=my-carriers) and All Carriers (?tab=all-carriers).
2

Find Instabox (Legacy API)

Card title Instabox (Legacy API) — not the current Instabox card. Yellow Deprecated badge. Buttons: Connect and Learn more.
3

Click Connect

Modal id connect-carrier-modal. Title Create new carrier. Subtitle Fill out the information below to create a new carrier.
4

Fill required fields

Shared fields first, then Client ID, Client Secret, and Customer Number. Sandbox Mode sits under Optional Fields.
5

Create

Click Create (shows Creating… while the request runs) or Cancel. Success toast: Carrier created successfully. Failure copy: Failed to create carrier. Please try again.
All Carriers grid with the Instabox Legacy API card marked Deprecated, Connect, and Learn moreAll Carriers grid with the Instabox Legacy API card marked Deprecated, Connect, and Learn more

Instabox (Legacy API) on All Carriers — Deprecated badge, Connect, Learn more

Create new carrier dialog for Instabox Legacy API with Client ID, Client Secret, and Customer NumberCreate new carrier dialog for Instabox Legacy API with Client ID, Client Secret, and Customer Number

Create new carrier for Instabox (Legacy API) — Client ID, Client Secret, Customer Number

Scroll Optional Fields for Sandbox Mode.
Instabox Legacy API connect form scrolled to Optional Fields and Sandbox ModeInstabox Legacy API connect form scrolled to Optional Fields and Sandbox Mode

Instabox (Legacy API) optional field — Sandbox Mode

​
Shared fields

​
Legacy credentials

Client Secret uses a password input because the label contains “Secret”. Helpers are catalog copy. This form does not have a single API Key. That field is on Connect Instabox.
Leave Sandbox Mode off for live orders. Mixing staging secrets with the checkbox off (or the reverse) fails at send time. Sandbox mode.

​
After you connect

The connection appears on My Carriers (Connected, Edit Carrier). Deprecated connections also show a Deprecated badge when you pick the carrier on a shipment. Products are not on this form — Carrier products and services. Legacy products (names as on Product *): Countries: Sweden, Norway, Denmark, Finland. Weight helper: 0.1 - 20 kg. Locker delivery needs a Service Point on the Drop Point card. Error: This carrier product delivers to a service point — select a droppoint before sending. Pick a service point. Tracking is push (same Instabox-format callbacks as the current Instabox card). No webhook URL on Edit your carrier — Carrier tracking webhooks. This carrier does not generate customs documents or commercial invoices in Zippendo. It does not appear in Pickups.

​
Edit

My Carriers → Edit Carrier. Title Edit your carrier.
  • General — Carrier name (helper: Update the name of your carrier), Brand when brands exist.
  • Carrier settings — Client ID, Client Secret, Customer Number, Sandbox Mode.
Save (pending Saving…) → Carrier updated successfully. Load failure: Failed to load carrier. Please try again. Save failure: Failed to update carrier. Please try again.

​
Delete

Delete on Edit your carrier. Title Delete Carrier. Body: This will permanently delete carrier “{{name}}”. This action cannot be undone. Type the carrier name in uppercase to enable Delete. Toast: Carrier deleted successfully. Booked shipments keep labels and tracking. After you migrate, connect Instabox and then delete this legacy connection if you no longer need it.

​
Common errors

Putting a current Instabox API Key into Client ID / Client Secret will not work. Use Connect Instabox for that key.