Shopify technical setup
Connect your store in Settings, or push order JSON through the advanced API endpoint.
Recommended: Settings connect
In the app, open Settings → API Integration → Shopify. Create a Shopify custom app with the scopes below, then paste store URL, Client ID, and Client Secret. Circle Routes registers order webhooks and imports matching orders as delivery tasks.
Sync modes: Import only, or Import and update Shopify (mark fulfilled when the driver completes delivery). Optional order tag filters use AND / OR.
Required scopes
read_fulfillments,write_fulfillments,read_merchant_managed_fulfillment_orders,write_merchant_managed_fulfillment_orders,read_orders,write_ordersWebhook receiver
POST {YOUR_API_HOST}/api/v1/webhooks/shopifyRegistered automatically on connect. Verified with Shopify HMAC using your custom app client secret.
Advanced: push endpoint
For Zapier or custom middleware you can still push Shopify order objects with the workspace API key:
POST {YOUR_API_HOST}/api/v1/delivery-tasks/push/shopify/ordersX-API-Key: {your API key from Settings → API Integration}What gets mapped
Customer name, phone, email, shipping address, city, line-item quantity as box count, order number, and an AWB of SHP-{order id}. Connected import uses today when the Shopify created_at is in the past.
Not mapped: COD, skills, time windows, coordinates, weight, merchant, or task type. Use bulk push for those fields.