> ## Documentation Index
> Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Instabox

> Connect Instabox from Carriers → All Carriers — Instabee Integration API Key and optional Sandbox Mode.

**Instabox** books locker and home labels across Sweden, Norway, Denmark, and Finland. The catalog card copy is: **Instabox delivers parcels to lockers and homes across the Nordics (Sweden, Norway, Denmark, Finland) via the Instabee network**.

The product on **All Carriers** is **Instabox**. Catalog slug: `instabox`. This is not [Instabox (Legacy API)](/docs/how-to/connect-instabox-legacy). Shared chrome: [Carrier credentials](/docs/how-to/carrier-credentials). Inventory: [Connect a carrier or integration](/docs/how-to/connect-index). Walkthrough: [Carriers](/docs/tutorials/carriers).

<Info>
  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](/docs/how-to/shipping-rule-fields).
</Info>

## Prerequisites

* An Instabox shipping agreement. **Learn more** on the catalog card opens [instabee.com](https://instabee.com).
* The **API Key** named on the form: **Your Instabee Integration API key (sent as 'Authorization: ApiKey \<key>')**.
* Permission to create carriers in the organization.

## Connect from All Carriers

<Steps>
  <Step title="Open All Carriers">
    Sidebar **Carriers**. Page title **Carriers / Integrations**. Header tabs: **My Carriers** (`?tab=my-carriers`) and **All Carriers** (`?tab=all-carriers`).
  </Step>

  <Step title="Find Instabox">
    Card title **Instabox** (exact name — not **Instabox (Legacy API)**). Buttons: **Connect** and **Learn more** (opens [instabee.com](https://instabee.com) in a new tab). The current Instabox card is **not** marked **Deprecated**.
  </Step>

  <Step title="Click Connect">
    Modal id `connect-carrier-modal`. Title **Create new carrier**. Subtitle **Fill out the information below to create a new carrier**.
  </Step>

  <Step title="Fill required fields">
    Shared fields first, then **Carrier Configuration → Required Fields** (**API Key**). **Sandbox Mode** sits under **Optional Fields**.
  </Step>

  <Step title="Create">
    Click **Create** (shows **Creating…** while the request runs) or **Cancel**. Success toast: **Carrier created successfully**. Failure copy in the modal: **Failed to create carrier. Please try again.**
  </Step>
</Steps>

<Frame caption="Instabox on All Carriers — Connect and Learn more">
  <img src="https://mintcdn.com/zippendo/pwy1g1EbXWJlGtUC/images/how-to/connect-instabox/01-all-carriers-card-light.png?fit=max&auto=format&n=pwy1g1EbXWJlGtUC&q=85&s=990b6582dc28d6fb2b15f3b429ac6479" alt="All Carriers grid with the Instabox card, Connect, and Learn more" className="block dark:hidden" width="2880" height="1800" data-path="images/how-to/connect-instabox/01-all-carriers-card-light.png" />

  <img src="https://mintcdn.com/zippendo/pwy1g1EbXWJlGtUC/images/how-to/connect-instabox/01-all-carriers-card-dark.png?fit=max&auto=format&n=pwy1g1EbXWJlGtUC&q=85&s=53d8ce0c7fe1358b2973b1f95b0f0e44" alt="All Carriers grid with the Instabox card, Connect, and Learn more" className="hidden dark:block" width="2880" height="1800" data-path="images/how-to/connect-instabox/01-all-carriers-card-dark.png" />
</Frame>

<Frame caption="Create new carrier for Instabox — API Key and Sandbox Mode">
  <img src="https://mintcdn.com/zippendo/pwy1g1EbXWJlGtUC/images/how-to/connect-instabox/02-connect-modal-light.png?fit=max&auto=format&n=pwy1g1EbXWJlGtUC&q=85&s=265fef4f299151b818867924311e31d0" alt="Create new carrier dialog for Instabox with required API Key and optional Sandbox Mode" className="block dark:hidden" width="2880" height="1800" data-path="images/how-to/connect-instabox/02-connect-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/pwy1g1EbXWJlGtUC/images/how-to/connect-instabox/02-connect-modal-dark.png?fit=max&auto=format&n=pwy1g1EbXWJlGtUC&q=85&s=d0ffda994b4e4fed2b2fca7926dc5f5d" alt="Create new carrier dialog for Instabox with required API Key and optional Sandbox Mode" className="hidden dark:block" width="2880" height="1800" data-path="images/how-to/connect-instabox/02-connect-modal-dark.png" />
</Frame>

## Shared fields

| Field               | Required | What it is                                                                                                                                                                                             |
| ------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Carrier name \*** | Yes      | Display name in **My Carriers** and on shipments. Placeholder **Enter carrier name**. Defaults to **Instabox**. Letters, numbers, and `. & ' + / ( ) _ -` only.                                        |
| **Brand**           | No       | Only when the organization has [brands](/docs/how-to/create-a-brand). Label **Brand**. Helper: **Only this brand can use this carrier.** Leave unset for organization-wide. Hidden when you have no brands. |

## Instabox credentials

**Carrier Configuration** splits into **Required Fields** and **Optional Fields**. Helpers are catalog copy.

| Field            | Required | Control                                                                                      | Where you get it                                                                                          | Format                                                                              | Sandbox vs live                                                                                  |
| ---------------- | -------- | -------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| **API Key**      | Yes      | Text. Helper: **Your Instabee Integration API key (sent as 'Authorization: ApiKey \<key>')** | The Integration API key for your Instabox account. **Learn more** → [instabee.com](https://instabee.com). | String. Sent as `Authorization: ApiKey <key>` (verbatim — do not Base64-decode it). | Same key. **Sandbox Mode** switches host, not the key field.                                     |
| **Sandbox Mode** | No       | Checkbox, default off. Helper: **Use the Instabee sandbox environment**                      | Zippendo checkbox.                                                                                        | Boolean.                                                                            | On: `https://sandbox-api.integration.instabee.com`. Off: `https://api.integration.instabee.com`. |

There is no client id, client secret, or customer number on this form. Those fields belong to [Instabox (Legacy API)](/docs/how-to/connect-instabox-legacy).

<Warning>
  Leave **Sandbox Mode** off for live orders. Details: [Sandbox mode](/docs/how-to/sandbox-mode).
</Warning>

## After you connect

The connection appears on **My Carriers** with a **Connected** badge and **Edit Carrier**. Products are **not** on this form — [Carrier products and services](/docs/how-to/carrier-products-and-services).

Instabox products (names as on **Product \***):

| Product             | Type     | Service point?                        |
| ------------------- | -------- | ------------------------------------- |
| **Locker delivery** | Outbound | Yes — recipient picks a locker        |
| **Home delivery**   | Outbound | No — Instabox schedules the home slot |
| **Locker return**   | Inbound  | Yes — consumer drops at a locker      |

Sender and destination countries in the catalog: Sweden, Norway, Denmark, Finland. Weight helper: **0.1 - 20 kg**. Instabox has no **Home return** product on this integration.

### Lockers (droppoint)

**Locker delivery** and **Locker return** are service-point products. On **Create Shipment** the card title is **Drop Point** and the required field is **Service Point \***. Error: **This carrier product delivers to a service point — select a droppoint before sending.** [Pick a service point](/docs/how-to/pick-a-service-point). [Droppoint vs service point](/docs/how-to/drop-point-and-service-points).

Instabox does **not** appear in **Pickups** — [Schedule a pickup](/docs/how-to/schedule-a-pickup).

Tracking is **push**. Connecting Instabox is enough; there is no webhook URL on **Edit your carrier** — [Carrier tracking webhooks](/docs/how-to/tracking-webhooks).

Instabox does not generate customs documents or commercial invoices in Zippendo.

If you still have the old OAuth Instabox API, migrate to this card — [Connect Instabox (Legacy API)](/docs/how-to/connect-instabox-legacy).

## Edit

On **My Carriers**, click **Edit Carrier**. Page title: **Edit your carrier**.

* **General** — **Carrier name** (helper: **Update the name of your carrier**), plus **Brand** when brands exist.
* **Carrier settings** — **API Key**, **Sandbox Mode**.

Header actions: **Delete** and **Save** (pending **Saving…**). Success toast: **Carrier updated successfully**. Loading: **Loading carrier…**. Load failure: **Failed to load carrier. Please try again.** Save failure: **Failed to update carrier. Please try again.**

## Delete

On **Edit your carrier**, click **Delete**. Modal id `global-delete-modal`. 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**. Failure: **Failed to delete carrier**.

Booked shipments keep their labels and tracking.

## Common errors

| When                            | Copy                                                                                                                                     |
| ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| Required field empty on connect | **Create** does nothing until **Carrier name** and **API Key** have values.                                                              |
| Connect request fails           | **Failed to create carrier. Please try again.**                                                                                          |
| Plan / resource cap             | **You have reached your plan limit for this resource.** / **You have exceeded your plan limits. Please upgrade or remove excess items.** |
| Send with bad credentials       | **The carrier rejected your API credentials. Update the carrier's API key or secret in Carrier settings.**                               |
| Locker product without a locker | **This carrier product delivers to a service point — select a droppoint before sending.**                                                |
| Product vs countries            | **The selected carrier product does not ship between these countries. Choose a different product.**                                      |
| Carrier down                    | **The carrier service is currently unavailable.** / **The carrier rejected the request.**                                                |

Auth failures after send: [Carrier authentication failures](/docs/knowledge-base/carrier-authentication-failures).

## Related

* [Connect a carrier or integration](/docs/how-to/connect-index)
* [Carrier credentials](/docs/how-to/carrier-credentials)
* [Sandbox mode](/docs/how-to/sandbox-mode)
* [Connect Instabox (Legacy API)](/docs/how-to/connect-instabox-legacy)
* [Connect an integration](/docs/how-to/connect-an-integration)
* [Request a carrier integration](/docs/how-to/request-carrier-integration)
* [Carriers](/docs/tutorials/carriers)