Skip to main content

Webhook Notifications

Pickpad sends HTTP POST webhooks to your configured URLs when order events occur. Configure webhook URLs in the Dashboard Settings.

Events

EventWhenWebhook Setting
distributedOrder assigned to a Pickpad deviceOrder distributed webhook
placedOrder marked as ready on the PickpadOrder prepared webhook
takenOrder picked up from the PickpadOrder taken webhook
canceledOrder canceled(not configurable separately)

Delivery

  • Webhooks are sent as POST requests with Content-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 taken event 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.