Carriers
Connecting a carrier lets TakeTheme create shipments for you, pull back tracking numbers and airway bills, and keep delivery status current — instead of you copying order details into the carrier's own dashboard.
| Carrier | Coverage | Status |
|---|---|---|
| Bosta | Egypt | Fully supported, including live status webhooks |
| Mylerz | Egypt and regional | Fully supported; status arrives via sync rather than webhooks |
| Turbo | — | Coming soon. Credentials save, but shipment creation is disabled |
You can connect one carrier at a time for automatic shipment creation.
Bosta
Settings → Shipping → Bosta.
| Credential | Required |
|---|---|
| API Key | Yes — from your Bosta merchant dashboard |
Mylerz
Settings → Shipping → Mylerz.
| Credential | Required |
|---|---|
| Username | Yes |
| Password | Yes |
| Country | Yes — the country your Mylerz account is registered in |
Mylerz also has a Service Type setting (default DTD, door-to-door) that selects the product your shipments are booked under.
Turbo
Credentials (API Key, Client Code) can be stored, but shipment creation and order listing reject Turbo, and its webhook does nothing. Don't build a workflow on it yet.
Settings
These apply to whichever carrier you connect.
| Setting | Default | What it does |
|---|---|---|
| Auto-sync orders | off | Master switch. When off, nothing is sent to the carrier automatically — no shipment creation, no status polling. See Tracking & sync. |
| Auto mark orders as fulfilled | off | Marks order items fulfilled as soon as the shipment is created, instead of you packing them by hand |
| Send confirmation email to customer | off | Emails the customer when the shipment is created. Only fires if auto mark as fulfilled is on. |
| Allow customer to open package | off (Turbo: on) | Passed to the carrier — whether the courier lets the customer inspect the contents before paying |
| Notify on sync errors (emails) | empty | Alerts these addresses when a shipment or status sync fails |
On cash-on-delivery, letting customers open the box before paying raises conversion and raises refusals at the door. Set it deliberately, not by default.
What you can do once connected
| Action | What it does |
|---|---|
| Create shipments | Pushes selected orders to the carrier and stores the returned tracking number and URL |
| Cancel shipment | Cancels the shipment at the carrier |
| Airway bill (AWB) | Fetches the printable label |
| Tracking URL | The customer-facing tracking link |
| Expected charges | Asks the carrier what a shipment will cost |
| Warehouses | Lists your pickup locations at the carrier |
| City / zone list | The carrier's own city and zone codes, for mapping addresses |
| Provider orders | Lists orders as the carrier sees them, to reconcile against your dashboard |
Manual shipment creation ignores the auto-sync switch — it's an explicit action, so it always goes through.
API reference
All carrier operations live under /v1/integrations/shipping:
| Action | Endpoint |
|---|---|
| Create shipments | POST /v1/integrations/shipping/:provider/create |
| Cancel shipment | POST /v1/integrations/shipping/:provider/cancel |
| Airway bill | POST /v1/integrations/shipping/:provider/awb |
| Tracking URL | GET /v1/integrations/shipping/:provider/tracking-url |
| Expected charges | POST /v1/integrations/shipping/:provider/charges |
| Warehouses | GET /v1/integrations/shipping/:provider/warehouses |
| City / zone list | GET /v1/integrations/shipping/:provider/city-zones |
| Provider orders | GET /v1/integrations/shipping/:provider/orders |