Tools

Create a webhook tool

Send structured events from a conversation to another system.

Updated August 3, 2026 · 9 min

When to use a webhook

Use a webhook when an agent must notify an external system—for example, to create a lead, open a task, or start an automation. It resembles an HTTP tool and uses POST by default.

Configure the event

  1. Create a Webhook tool.
  2. Enter the receiving HTTPS URL.
  3. Add required headers.
  4. Define data the agent must collect.
  5. Add fixed values identifying the event source or type.
{"event":"support_request_created","source":"inceptiva"}

Design a secure receiver

Protect the endpoint with a secret header, validate the payload, and respond quickly with 2xx. Process slow downstream work asynchronously.

Prevent duplicates

Networks or receivers may repeat a request. For actions that must run once, implement idempotency at the destination and include a unique event identifier.