This documentation is in beta, and might contain errors. Contact us at integration@instabee.com with any questions.

Instabee API

Home Delivery

Home Delivery is Instabee's main home delivery product. The standard integration is straightforward: validate the consumer's postal code to check if we deliver to their area, then create orders when they select our delivery option in checkout.

We also offer a more advanced version where consumers can choose between different delivery days. If this is something you would like to use, please talk to your Implementation Manager about the correct setup.

Feature Comparison

The following tables show what features are unlocked at each integration level. Higher levels provide better delivery options, accuracy, and consumer experience.

Availability Features

Level 0
No integration
Level 1
Get All Lockers
Level 2
Availability with:
Level 3
Availability with:
Level 4
Availability with:
Level 5
Availability with:
Level 6
Availability with:
Nothing
Country Code
Postal Code
Country Code
Postal Code
Country Code
Email
Postal Code
Country Code
Email
Recipient Address
Postal Code
Country Code
Email
Recipient Address
Cart info - Estimated size
Postal Code
Country Code
Email
Recipient Address
Cart info - Specific size
Alt, Product Sizes
Delivery Options
Geolocation
Advanced Ranking
Estimated Time of Arrival*
Capacity Managment
Parcel Size Optimisation

* This also required a commitment of packing times and pickup times for all parcels

Post Purchase Call Features

Level 0
Nothing
Level 1
Minimum amount of data
Level 2
Regular amount of data
Level 3
Great amount of data
Level 4
Awesome amount of data
Availability Token
Selected Brand
Selected Product
Selected Delivery Option
Availability Token
Selected Brand
Selected Product
Selected Delivery Option
Recipient Information
Availability Token
Selected Brand
Selected Product
Selected Delivery Option
Recipient Information
Parcel Dimensions
Availability Token
Selected Brand
Selected Product
Selected Delivery Option
Recipient Information
Parcel Cart Information
Identification Options
Delivery Instructions
Capacity Management
Smart Create Order
Operation Optimisation
Consumer Communication

Post Packing Call Features

Level 0
Nothing
Level 1
Minimum amount of data
Level 2
Regular amount of data
Level 3
Great amount of data
Level 4
Awesome amount of data
Level X
Order data is sent in Post Purchase
Nothing
Availability Token
Selected Brand
Selected Product
Recipient Information
Parcel ID
Availability Token
Selected Brand
Selected Product
Selected Delivery Option
Recipient Information
Parcel ID
Availability Token
Selected Brand
Selected Product
Selected Delivery Option
Recipient Information
Parcel Dimensions
Parcel ID
Availability Token
Selected Brand
Selected Product
Selected Delivery Option
Recipient Information
Parcel Cart Information
Identification Options
Delivery Instructions
Parcel ID
Parcel Confirmation
Parcel ID
Consumer Experience
Smooth Delivery

Typical Integration Workflow

  1. Validate Postal Code — Check if Instabee delivers to the consumer's area
  2. Consumer Selects Home Delivery — Show the home delivery option in checkout
  3. Post Purchase — After payment, register the order to reserve delivery capacity
  4. Fulfillment — Pack the order in your warehouse
  5. Post Packing — Confirm the parcel is packed and ready for pickup
  6. Pickup & Home Delivery — Instabee collects the parcel and delivers it to the consumer's door

API base URLs

Send production traffic to the production host and sandbox or test traffic to the sandbox host. Paths, headers, and request bodies are the same in both environments; use credentials issued for the environment you call.

EnvironmentBase URL
Productionhttps://api.integration.instabee.com/
Sandboxhttps://sandbox-api.integration.instabee.com/

Supported Countries

Instabee currently operates in the following countries:

  • Sweden (SE)
  • Norway (NO)
  • Denmark (DK)
  • Finland (FI)
  • Netherlands (NL)

Next Steps

Need help? Our technical support team is available to assist with your integration. Contact us at integration@instabee.com

Command Palette

Search for a command to run...