Create a webhook tool
Send structured events from a conversation to another system.
Updated August 3, 2026 · 9 minWhen 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
- Create a Webhook tool.
- Enter the receiving HTTPS URL.
- Add required headers.
- Define data the agent must collect.
- 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.