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 Zips
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...