Webhooks

A webhook sends a POST request to a URL of your choice when something happens in a demo. Use it to put leads in your CRM, post in Slack through Zapier or Make, or start your own automation.

Add a webhookCopy Anchor Link

1. Go to Leads → Webhooks, or Integrations → Webhooks.
2. Click Add webhook.
3. Enter the URL. It has to start with https://.
4. Choose the events to send.
5. Click Create webhook.
6. Click Send test webhook to check that it arrives.

You can add up to 10 webhooks per workspace.

EventsCopy Anchor Link

PayloadCopy Anchor Link

Every request has a JSON body like this:

{
  "event": "lead.captured",
  "timestamp": "2026-09-25T10:15:00.000Z",
  "data": {
    "demo": {
      "id": "abc123",
      "title": "Product tour",
      "url": "https://share.peutly.com/abc123"
    },
    "lead": {
      "email": "jane@example.com",
      "name": "Jane Doe",
      "firstName": "Jane",
      "lastName": "Doe",
      "phone": "",
      "company": "Example Inc",
      "country": "Netherlands",
      "optIn": true,
      "source": "cta"
    }
  }
}

• lead is filled in when the viewer submitted a form earlier in the same session, and null otherwise.
• source is cta for the CTA step, or overlay for a form in an overlay step.
• Fields the viewer didn't fill in are empty strings. country is the text the viewer typed.
• The request has the headers Content-Type: application/json and User-Agent: Peutly-Webhooks/1.0.

Delivery and retriesCopy Anchor Link

Your endpoint has 10 seconds to answer with a 2xx status. If it doesn't, Peutly tries again after 1 minute, 5 minutes, 30 minutes and 2 hours: 5 attempts in total.

Click Delivery logs to see every request, its status code and any errors.

SecurityCopy Anchor Link

Webhook requests are not signed yet. Anyone who knows your URL could send a fake request to it. To be safe:

• Use a long, random URL that's hard to guess, for example with a secret token in the path.
• Keep the URL private.
• Treat the data as untrusted until you've checked it.