Skip to content

Instabee

Instabee is a Stockholm-based last-mile delivery group that delivers e-commerce parcels across the Nordics and the Benelux. Instabee offers locker delivery and locker return services for parcels shipped within the Netherlands, Sweden, Denmark, Finland, and Norway.

This guide provides developers with the details needed to build Instabee shipping capabilities into your ShipStation V2 API workflows.

Beta

Instabee is currently in beta. Services and features may change as testing is completed.

Requirements

carrier_code: instabee

  • A contract with Instabee and the API key Instabee assigned to your merchant account. Instabee only issues API keys to merchants with a contract. If you already have a contract, contact your Instabee Implementation Manager, or email integration@instabee.com if you don't have a contact. Keep your API key secure and don't share it in public places.
  • Shipments must be domestic: the ship from and ship to addresses must both be in the same country, and that country must be the Netherlands (NL), Sweden (SE), Denmark (DK), Finland (FI), or Norway (NO).
  • The ship to address must include an email address and a phone number.
  • Locker Return shipments must also include an email address and a phone number in the ship from address, plus the package weight and dimensions.

Connect Account

Connect via Endpoint

POST /v2/connections/carriers/:carrier_code

POST /v2/connections/carriers/instabee HTTP/1.1
Host: api.shipstation.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json

{
  "api_key": "your_instabee_api_key"
}

A successful connection will return a response with the carrier_id, which you'll use for any requests for this account going forward.

The api_key is the API key Instabee assigned to your merchant account. You can also connect your account in the ShipStation dashboard.

Rates

Instabee supports rate shopping with ShipStation V2 API.

Service Details

Available services with Instabee are provided below. Please note that carriers may update their available services at any time. To ensure you are always using valid services, you can use the list carrier services endpoint at any time.

ServiceAPI CodeDirectionTransit Time
Locker Deliveryinstabee_locker_deliveryOutbound1-3 days
Locker Returninstabee_locker_returnReturn2-4 days

Both services are domestic only. Instabee collects Monday to Friday and delivers Monday to Friday.

Locker Delivery

Parcels are delivered to a nearby automated locker or pick-up point, ready for the recipient to collect on their schedule. The recipient receives notifications at every step. You can select the locker with the dropoff_location property. See Service Points.

Locker Return

Locker Return is a standalone, labelless return service. It is not connected to an outbound Locker Delivery parcel. The customer drops the parcel in a locker without a printed label, and Instabee generates the label when they collect the parcel. Because there is no label to print, the response includes paperless instructions telling the customer to follow the instructions sent by SMS to complete the drop-off. Instabee then delivers the parcel back to you.

Locker Return requires a locker and the parcel size, which you provide with the package dimensions. You select the locker with the dropoff_location property. See Service Points.

Packages

PackageAPI Code
Boxinstabee_box
Baginstabee_bag

Size and Weight Limits

These limits apply to both Instabee services.

MinimumMaximum
Dimensions (L x W x H)1 x 1 x 1 cm60 x 40 x 41 cm
Weight0.01 kg20 kg

Delivery Confirmation

Instabee does not support delivery confirmation options. Shipments use "No Confirmation Required."

Label Support

  • Label size: 4" x 6"
  • Label formats: PDF, ZPL (Locker Delivery only)
  • Locker Return does not generate a label. See Locker Return.

Voiding Labels

Instabee supports voiding labels with ShipStation V2 API, but Instabee's API doesn't support cancelling locker shipments. Voiding a label only voids it in ShipStation. To cancel the shipment with Instabee, you must contact Instabee directly.

Service Points (PUDO)

Instabee supports service points. Use the service point endpoints to find Instabee lockers and ship to the one you select. Locations include opening hours.

The lockers available to you depend on your Instabee account. The list is based on the locations Instabee assigns to your API key, and it is refreshed every 8 hours.

Tracking

Instabee supports receiving tracking updates. Review our Track a Package guides for details on tracking with the ShipStation V2 API.

You don't need to set up a tracking webhook. ShipStation subscribes to tracking updates for you.

Recipients can follow a parcel on the Instabee tracking page at https://track.instabox.com/{tracking_number}.

Tracking events use Instabee checkpoint types as the carrier status code, and ShipStation maps each one to a status_detail_code. The tracking number is the Instabee parcel ID. The checkpoint types below are examples. Instabee can configure additional events for specific cases.

Checkpoint TypeDescriptionStatus Detail Code
InitialCheckpointOrder information receivedELEC_ADVICE_RECD_BY_CARRIER
InitialReturnCheckpointReturn activatedELEC_ADVICE_RECD_BY_CARRIER
SortingMachineCheckpointSortedHUB_PROCESSING
SortingStationCheckpointSortedHUB_PROCESSING
CourierDropoffCheckpointDropped off at locker by courierDELIVERED_TO_PICKUP_POINT
CourierPickupCheckpointPicked up at locker by courierPICKED_UP
CustomerPickupCheckpointPicked up at locker by customerPARCEL_COLLECTED_FROM_PICKUP_POINT
CustomerDropoffCheckpointDropped off at locker by customerAWAITING_PICKUP_DROP_OFF
ReturnToSenderCheckpointReturn to senderRETURN_TO_SENDER
ReturnedToSenderCheckpointParcel returned to senderDELIVERED
ParcelLostCheckpointParcel was lostPARCEL_LOST
ChangePickupPointCheckpointConsumer initiated pickup point change, which can affect delivery timeINFORMATION