Tailflow
Skip to article
Browse documentation

Actions

Webhook

Send flow data to your own application or automation endpoint.

Configure the destination

Add Webhook and set URL to a public endpoint that accepts a JSON POST. Use the Sends preview to inspect the body. A local or private-network address cannot receive these requests.

This is an outgoing action. It is not an incoming webhook trigger, and the current UI does not provide a custom body or header editor.

Webhook Action Configuration
Path 1
Every event
Webhook
Selected action
1Webhook
Sends
{ "version": 1, "flow_id": "example-flow", "event": { "token_symbol": "USDC" }, "actions": {} }
Continue on error
A failure stops later actions on this path.
Example. URL is the destination you configure. Sends previews the fixed request body, with the event and earlier outputs on this path.Changes stay in this example. Nothing is saved or sent.

Understand the body

The body contains version, flow_id, event, and actions. actions holds earlier outputs on the same path; it does not include later actions or other paths. Use Transform before Webhook to add a purpose-built output.

Webhook Action Configuration
Path 1
Every event
Webhook
Selected action
1Webhook
Sends
{ "version": 1, "flow_id": "example-flow", "event": { "token_symbol": "USDC" }, "actions": {} }
Continue on error
A failure stops later actions on this path.
Example. URL is the destination you configure. Sends previews the fixed request body, with the event and earlier outputs on this path.Changes stay in this example. Nothing is saved or sent.
JSON
{
  "version": 1,
  "flow_id": "your-flow-id",
  "event": { "token_symbol": "USDC", "value_decimal": "100000" },
  "actions": {}
}

Delivery and authentication

A 2xx response is recorded as completed; rejected requests and other failures appear in the run. The test preview does not contact your endpoint.

Webhook delivery signing is not available in this version. Creating a Webhook connection does not add a signature to deliveries. Do not build a receiver that assumes a Tailflow signature is present.

Webhook Test Preview and Run Result
Test run · Webhook
URL
https://example.com/hooks/transfers
Outcome
Would send
Run · Webhook · Completed
Sent
POST https://example.com/hooks/transfers
Received
HTTP 200
Example. A dry test previews the request. After a live event, expand Webhook in Runs to check whether the endpoint accepted it.Changes stay in this example. Nothing is saved or sent.