Outbound webhooks

Plan: available on Growth, Pro, and Custom plans. Who's this for: anyone who wants new leads, conversations, or other agent events to land instantly in their own tools — Zapier, Make.com, n8n, a Slack bot, an internal CRM, you name it.

#What is a webhook?

A webhook is just a URL that we call whenever something interesting happens on your agent. Instead of you logging in to check for new leads, we push them to you in real time.

A simple example:

Someone fills out a "Get a quote" form on your site. Within a second, we POST the lead's name, email, and conversation transcript to a URL you control. Your tool then creates a row in a spreadsheet, posts to Slack, or whatever you need.

#Before you start

You'll need:

1. A URL that accepts a POST request and returns 200 OK. Most automation tools (Zapier, Make.com, n8n) generate one of these for you in a few clicks.
2. The Coffield.io dashboard for your tenant.
3. The Growth plan or higher.

You don't need to write any code. But you do need a URL that can receive JSON.

#Setting up your first webhook

1. Sign in to your dashboard.

2. Open AI Agents → Webhook Endpoints in the left navigation.

3. Click New Webhook Endpoint.

4. Pick which agent the webhook belongs to.

5. Paste the destination URL (must start with https:// — http:// is blocked for safety).

6. Tick the events you want delivered. Use * to receive everything, or pick specific events:

   Event	Fires when
   lead.created	A visitor submits the agent's lead form
   booking.created	A visitor books an appointment through the scheduling tool
   support.ticket.created	A visitor opens a support ticket
   quote.submitted	A visitor finishes the quote intake flow
   crawl.completed	A site crawl finishes successfully (Site Crawl v3 — Pro)
   crawl.failed	A site crawl errors out (Site Crawl v3 — Pro)
   (custom event name)	A workflow recipe fires a fire_webhook_event step (see Workflows)

7. Click Create.

Done. We'll start delivering events to your URL within seconds of them happening.

#What you'll receive

Every delivery is a POST request with a JSON body and three headers you may care about:

The signature lets your tool prove the request really came from us. If you're using Zapier or Make.com, you can usually ignore it. If you're writing custom code, your endpoint's secret is shown once when you create the webhook — keep it safe.

#Retries and failures

If your endpoint is down or returns a non-2xx response, we'll retry automatically with exponential backoff (30s, 1m, 2m, 4m, 8m). After five failed attempts, the delivery is marked abandoned and we stop trying.

You can see every delivery — sent, failed, retried, or abandoned — under AI Agents → Webhook Deliveries. Click any row to see the request body, response code, and any error message.

#Rate limits

To keep things stable for everyone, we cap outbound webhook deliveries at 60 per minute per tenant. If a burst of activity pushes you past that limit, we'll queue the extras and deliver them in the next minute — nothing is dropped. In practice, this is more than enough headroom for normal use.

#Pausing or removing an endpoint

• To pause: edit the endpoint and toggle it off. We'll stop sending to it but keep the configuration.
• To delete: click the row actions menu → Delete. The history of past deliveries is preserved.

#Common questions

Can I have more than one webhook? Yes — up to 10 per agent.

Can I send to my Slack channel? Yes, indirectly. Create a Zapier or Make.com webhook that posts to Slack, and use that URL here.

Why is it greyed out? Outbound webhooks require the Growth plan or higher. Upgrade from Account → Subscriptions.

Something looks broken. Email support@coffield.io with the Delivery ID from the failing delivery — we can trace it instantly.