Webhook Notifications
Pickpad sends HTTP POST webhooks to your configured URLs when order events occur. Configure webhook URLs in the Dashboard Settings.
Events
| Event | When | Webhook Setting |
|---|---|---|
distributed | Order assigned to a Pickpad device | Order distributed webhook |
placed | Order marked as ready on the Pickpad | Order prepared webhook |
taken | Order picked up from the Pickpad | Order taken webhook |
canceled | Order canceled | (not configurable separately) |
Delivery
- Webhooks are sent as
POSTrequests withContent-Type: application/json - Failed deliveries are retried up to 3 times with exponential backoff
- Duplicate events are deduplicated (same payload won't be sent twice within 60 seconds)
- Request timeout: 10 seconds
- The
takenevent has a configurable delay (default 30s) to allow weight measurement
Request Headers
Content-Type: application/json
Accept: application/json
User-Agent: Pickpad API
X-Request-Source: pickpad-webhook-notifier
X-Request-Source-Version: 1.0.0
Static IP Proxy
If your firewall requires IP whitelisting, enable Use static IP for webhooks in Settings. All webhooks will be routed through 34.31.226.91.