Webhook basics

Webhooks push real-time notifications to your server whenever something happens in your account, so you don't have to poll the API.

How it works

You register a URL, and we send an HTTP POST with a JSON payload each time a subscribed event fires, for example invoice.paid or customer.created.

  • Respond with a 2xx status within a few seconds.
  • Verify the signature header before trusting any payload.
  • Make handlers idempotent — the same event may be delivered more than once.

Example endpoint

Point your webhook at a publicly reachable URL such as https://hooks.example.com/perfex and log the raw body while testing.

Did you find this article useful?