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.
Instabee is currently in beta. Services and features may change as testing is completed.
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.
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.
Instabee supports rate shopping with ShipStation V2 API.
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.
| Service | API Code | Direction | Transit Time |
|---|---|---|---|
| Locker Delivery | instabee_locker_delivery | Outbound | 1-3 days |
| Locker Return | instabee_locker_return | Return | 2-4 days |
Both services are domestic only. Instabee collects Monday to Friday and delivers Monday to Friday.
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 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.
| Package | API Code |
|---|---|
| Box | instabee_box |
| Bag | instabee_bag |
These limits apply to both Instabee services.
| Minimum | Maximum | |
|---|---|---|
| Dimensions (L x W x H) | 1 x 1 x 1 cm | 60 x 40 x 41 cm |
| Weight | 0.01 kg | 20 kg |
Instabee does not support delivery confirmation options. Shipments use "No Confirmation Required."
- Label size: 4" x 6"
- Label formats: PDF, ZPL (Locker Delivery only)
- Locker Return does not generate a label. See Locker Return.
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.
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.
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 Type | Description | Status Detail Code |
|---|---|---|
InitialCheckpoint | Order information received | ELEC_ADVICE_RECD_BY_CARRIER |
InitialReturnCheckpoint | Return activated | ELEC_ADVICE_RECD_BY_CARRIER |
SortingMachineCheckpoint | Sorted | HUB_PROCESSING |
SortingStationCheckpoint | Sorted | HUB_PROCESSING |
CourierDropoffCheckpoint | Dropped off at locker by courier | DELIVERED_TO_PICKUP_POINT |
CourierPickupCheckpoint | Picked up at locker by courier | PICKED_UP |
CustomerPickupCheckpoint | Picked up at locker by customer | PARCEL_COLLECTED_FROM_PICKUP_POINT |
CustomerDropoffCheckpoint | Dropped off at locker by customer | AWAITING_PICKUP_DROP_OFF |
ReturnToSenderCheckpoint | Return to sender | RETURN_TO_SENDER |
ReturnedToSenderCheckpoint | Parcel returned to sender | DELIVERED |
ParcelLostCheckpoint | Parcel was lost | PARCEL_LOST |
ChangePickupPointCheckpoint | Consumer initiated pickup point change, which can affect delivery time | INFORMATION |