Docs

WMS webhook.

Send orders from your WMS, ecommerce, or TMS into Trackely in real time with a tenant-specific webhook.

Getting the URL and secret

In the dashboard, go to Settings to Integrations and create a webhook. You will receive a webhook URL and a secret shown once for Bearer authentication.

Authentication

Every request must include the secret in the Authorization header.

Authorization: Bearer YOUR_SECRET

Payload

Send a JSON body as either a single order object or an array of order objects. Each order is created or updated byexternalOrderId.

  • externalOrderId is required
  • deliveryAddress is required if no customerId is provided
  • plannedDate should use YYYY-MM-DD

Example

{
  "externalOrderId": "WMS-ORD-001",
  "deliveryAddress": "10 High Street, London SW1A 1AA",
  "customerName": "Acme Ltd",
  "plannedDate": "2025-02-22"
}

Batch behaviour

Processing is fail-fast. If any item fails validation, the request returns an error and no orders are created or updated.

Pull from WMS

Trackely can also pull from an external endpoint instead of waiting for pushes. The returned JSON should match the same payload shape as the webhook.

For other ways to get orders into Trackely, read Importing orders.