Set up a webhook

Who this is for: Developers who want to receive events on their own server.

What this does: Sends a signed HTTP POST to your endpoint whenever an event fires.

Before you begin

  • You have an HTTPS endpoint that can accept POST requests.

  • You're an admin (Settings → Members shows your role).

Steps

  1. Go to Settings → Integrations → Webhooks.

  2. Click Add endpoint and paste your HTTPS URL.

  3. Choose the events to subscribe to and click Save.

Each delivery includes a signature header you should verify:

{
  "id": "evt_1a2b3c",
  "type": "deal.won",
  "created": 1785772800,
  "data": { "deal_id": "d_98213", "amount": 4200 }
}

Keep your signing secret private. Never log it or commit it to source control. Rotate it from Settings → Webhooks → Roll secret if it is ever exposed.

Verify it worked

Trigger a test event from Webhooks → Send test. Your endpoint's log shows a 200 and the webhook row shows a Success delivery within a few seconds.

Troubleshoot

  • Deliveries show failed? Your endpoint returned a non-2xx status or timed out (10s limit). Check your server logs.

  • Signature check fails? You're verifying against the wrong secret — copy it again from the endpoint's detail page.

Related