Skip to main content

Trigger workflows with webhooks

Learn how to automate tasks using webhook events with Retool Workflows.

You can add webhook triggers that run workflows automatically whenever it receives a webhook event, such as a service monitoring alert or when a payment is received. The workflow can reference data in the event's JSON payload in the same way as other block data. If necessary, you can also configure a workflow to respond to webhook events using the Response block, returning data back to the webhook origin.

Add a webhook trigger

To add a trigger, click the Start block or the Triggers button in the left panel.

Send a webhook event

Do not publicize endpoint URLs

Any request sent to the specified endpoint will trigger the workflow. Do not share or publicize this information.

Copy the endpoint URL and use it as the webhook event destination to trigger webhook events. You can also copy the provided cURL command to manually invoke the webhook trigger as you build and test your workflow. This includes the endpoint URL to use.

Webhook events sent to the workflow endpoint must useContent-Type: application/json. A JSON payload is optional.

Retrieve event payload

Workflows can read data from a webhook event's JSON payload (e.g., error message or confirmation number) and make it available to your workflow. You can then use these parameters anywhere in your workflows with the startTrigger object. You can optionally provide example JSON input, such as an existing payload, to build and test your workflow in the editor. The specified JSON is also included in the curl command.

Retrieve data from the webhook payload.