Skip to main content

Webhooks

ProcureIQ webhooks deliver real-time events for orders, payments, support, products, and automations.

Register a subscription​

curl --request POST https://api.procureiq.com/api/v1/webhooks \
  --header 'x-api-key: piq_live_xxx' \
  --header 'content-type: application/json' \
  --data '{
    "name": "Fulfilment system",
    "url": "https://example.com/webhooks/procureiq",
    "events": ["order.created","payment.succeeded"]
  }'

Delivery headers​

  • x-procureiq-signature
  • x-procureiq-event
  • x-procureiq-delivery
  • x-procureiq-timestamp

Handling guidance​

  1. Verify the signature.
  2. Respond with a 2xx quickly.
  3. Queue internal work asynchronously.
  4. Use delivery replay for recovery.