Developers

Fire a webhook when a lead comes in

Point a webhook at your own endpoint, receive lead payloads the moment they hit the CRM, and verify the signature so you trust the source.

Intermediate12 min·
Fire a webhook when a lead comes in

Point a webhook at your own endpoint, receive lead payloads the moment they hit the CRM, and verify the signature so you trust the source.

What you'll build

A webhook that fires the instant a lead lands in the Growthzi CRM, delivers the lead payload to your own endpoint, and gets acknowledged with a 200. You end up able to trigger downstream automation (call your data warehouse, ping a Slack channel, push into your billing system) without polling the CRM. You also verify the request signature so you know the payload is really from Growthzi.

How Growthzi does it

Every Growthzi tenant has a Webhooks panel that lists triggers (lead.created, order.paid, booking.confirmed, and more), a URL per trigger, and an HMAC signing secret. When the trigger fires we POST JSON to your URL and sign the body with the secret in the X-Growthzi-Signature header. If your endpoint returns anything other than 2xx we retry with exponential backoff for 24 hours before giving up.

Step by step

  1. Open the CRM, go to Settings, then Webhooks
  2. Click New webhook, pick lead.created as the trigger
  3. Paste the URL of your own endpoint that can accept a POST
  4. Copy the signing secret into your endpoint's environment
  5. In your endpoint, verify the X-Growthzi-Signature header before processing
  6. Submit a test lead form on your site and confirm your endpoint received it

Start building on Growthzi today.

Describe your business in a sentence. Growthzi generates your site, sets up your CRM, and writes the first month of social content.

Get StartedNo credit cardLive in 60s
Loading your dashboard