Overview
- Aggregated dispatch: One connection reaches First’s whole courier network
- Auto-dispatch: Orders are sent to First automatically when you accept them
- Live tracking: Courier status updates flow back to the storekit order page
- Coverage by location: Which couriers a venue can use depends on the First merchant location (its address and territory), not on anything storekit sends
First Delivery decides which courier network fulfils each job based on the merchant location you connect. storekit does not choose the courier — it dispatches the order and relays the status First reports.
Before You Start
You need:- A First Delivery account with an API key (from your First account)
- A complete venue address in storekit (used to match or create your First merchant location)
- Delivery enabled on the store (see Enabling Delivery)
Setup
- In storekit, go to Stores → your store → Settings → Integrations
- Select First Delivery
- On the First Delivery Settings page, paste your key into API key and click Load merchants Loading merchants also validates the key — if First rejects it, you’ll be asked to check the key and try again.
- Under Merchant location, choose the merchant that matches this venue. If no locations are found for your key, use Create this venue as a new First location (see below).
- Set Integration status to enabled — the toggle reads “Enabled - dispatching orders to First Delivery” when on.
- Click Save.
Make sure your account has valid billing / payment details before you start taking delivery orders. If billing details are missing or a payment fails, can refuse to create delivery jobs even though storekit accepts and charges the order — check this in your account first if an order is paid but no delivery appears, then contact support with the order so we can look into it and, where possible, arrange the delivery manually.
Creating a First Location From Your Venue
If your API key has no existing merchant location for this venue, click Create this venue as a new First location under Merchant location. storekit creates a live location record at First from this venue’s details and selects it for you. If First can’t create the location, storekit shows the reason:If the merchant you pick looks like it’s in a different place from your venue, storekit warns that the selected merchant’s address doesn’t appear to match — picking the wrong location sends couriers to the wrong site, so double-check before saving.
Replacing the API Key
Once a key is saved, the API key field shows “API key saved ●●●●” with a Replace key button. Click Replace key to enter a new key, then Load merchants to validate it and refresh the merchant list.How It Works
- A customer places a delivery order on your storekit store
- When you accept the order, storekit dispatches it to First Delivery
- First routes the job to a courier in its network for the merchant location’s area
- Courier status updates arrive back at storekit and show on the customer’s order page
- If the order is cancelled in storekit, storekit cancels the First delivery too
Pickup Timing
First’s pickup time is when the courier collects from your venue, so storekit works it back from the customer’s estimated delivery time by the delivery leg. Scheduled orders need a pickup more than about 20 minutes out; anything sooner is dispatched as ASAP.Delivery Status Updates
storekit maps First’s courier statuses onto the tracking states customers see, including:Related
- Enabling Delivery — turn on delivery orders for your store
- Integrations Overview — all available integrations
- Managing Live Orders — handle incoming delivery orders