Hand-offWebhook

Webhook

Send hand-off payloads to your own HTTPS endpoint with optional signing and tests.

Setup

  1. Open Settings → Hand-off and select Webhook.
  2. Add connection and set:
    • URL of your listener (HTTPS)
    • Optional secret for signature verification on your side
    • Timeout in milliseconds
    • Optional custom headers (for example auth to an internal API gateway)
  3. Use Test webhook to load a sample JSON payload from the API, optionally adjust headers, and send a trial request. Inspect HTTP status and body in the UI.
  4. Attach this connection under Agents → Hand-off for agents that should use it.

What you get

Your service receives a machine-readable payload when a hand-off fires. You can route into any downstream system (Jira, internal CRM, data lake, etc.).

Feature notes

  • Contract: The test template reflects the current payload shape; version your consumer if the API adds fields.
  • Security: Validate signatures, use TLS, and reject unexpected content types on your endpoint.

See also Hand-off overview.