A Bosta-connected store with pickup and webhook updates
A store shipping daily with Bosta wants the full connection: API key, connection test, area mapping, pickup requests from the pickup location, and automatic status updates via webhook.
A store shipping daily with Bosta needs more than a send button: a test that reassures before launch, a correct city mapping that prevents stuck orders, regular warehouse pickup that spares delivery errands, and status updates arriving automatically without pressing a button each time. A partial connection means a daily chase: an order stuck over an unmapped city, a parcel out without pickup, and a status that only refreshes manually. A full connection from day one prevents that chase.
From Shipping Carrier Integrations the Bosta API key is entered, then save settings until the connected and active badge appears, then test connection, which calls the Bosta cities service. Next the store city is mapped to a Bosta code in area mapping. For follow-up: refresh tracking pulls the status, create pickup books a pickup from the pickup location, and the generated webhook token is placed in the Bosta dashboard with the dedicated header so status updates arrive automatically.
In practice, start by entering the key and saving, then test the connection before any real send, and never skip that step. Map every target shipping city from the area mapping and review codes carefully. Enable the webhook early to receive updates automatically, and make pickup requests part of the daily preparation routine.
Among the limits worth knowing, live tracking depends on Bosta itself, and pickup may require a valid pickup location on the carrier account. Secret fields appear empty after saving and are left blank to keep the current value, so never re-enter the key unnecessarily.
Mapped capabilities
- shipping.bosta.supported — Bosta shipping integration: Available
- shipping.carriers.connect — Connecting shipping carriers: Available
- shipping.tracking — Shipment tracking on orders: Available
Frequently Asked Questions
What is the order of steps for connecting Bosta the first time?
Enter the API key and save settings until the connected and active badge appears, then run the connection test, afterwards map shipping cities from the area mapping, and finally enable the webhook to receive status updates automatically.
How do shipment status updates reach me automatically?
Place the platform-generated webhook token in the Bosta dashboard with the dedicated header, and Bosta pushes status updates to your store as they happen with no need to press the refresh button manually each time.
Why does the key field appear empty after saving?
Secret fields are deliberately hidden after saving for protection and left blank to keep the current value, so re-enter the key only when actually rotating it, and any save with the field blank preserves the existing connection.
Related use cases
Last verified: 2026-09-18