Webhook Notifications

Pickpad can notify your server the moment order events happen, by sending an HTTP POST webhook to whatever URL you configure. Set your webhook URLs in Webhook URLs.

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
weight_deviation	Measured weight doesn't match the order while it's in progress	Order accuracy webhook
canceled	Order canceled	Order canceled webhook

See Webhook Events for the full payload of each event, and Webhook Payload for the shared field reference (including queueId and cluster).

Delivery

• Webhooks go out as POST requests with Content-Type: application/json
• If a delivery fails, it's retried up to 3 times with exponential backoff
• Duplicates are filtered out — the same payload won't be sent twice within 60 seconds
• Requests time out after 10 seconds
• The taken event has a configurable delay (default 30s) so the pad has time to get an accurate weight measurement first

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
X-Webhook-Secret: <your account's webhook secret>

X-Webhook-Secret is unique per account — a value generated for you, shown (read-only) as Webhook secret in Webhook URLs. Check this header on incoming requests to confirm a webhook genuinely came from Pickpad rather than a spoofed request to your endpoint.

Static IP Proxy

Need IP whitelisting for your firewall? Enable Use static IP for webhooks in Settings, and all webhooks will be routed through 34.31.226.91.