Retool Workflows triggers

Learn how to configure workflows to run automatically.

πŸŽ‰

beta

Retool Workflows is currently in public beta for Retool Cloud organizations. Sign up to get started β†’

You can automate workflows using a custom schedule or in response to webhook events. This enables you to build workflows that automatically perform actions on a regular basis or whenever a certain event occurs with an external service that supports webhooks.

Trigger workflows automatically

Every workflow contains a Start block that contains Trigger settings for you to configure. Whenever these trigger conditions are met, the Start block triggers the workflow to run automatically.

Workflows are not triggered automatically by default. After verifying that a workflow runs as expected, toggle Enable.

Schedule

Select the Schedule trigger to configure a workflow to run periodically. You can use Interval mode to specify the frequency using a set of options or Cron mode to set a schedule with more granularity using cron syntax.

For either mode, you also specify a timezone so that the workflow schedule runs based on local time.

Interval

You can configure a schedule that triggers every n minutes, hours, days, weeks, or months.

Interval scheduleInterval schedule

Cron

Retool Workflows supports cron syntax when configuring a schedule. The block displays a human-readable version of the values you provide. You can also hover the cursor over the label for each input to display a tooltip with syntax reference.

Cron syntax enables you to define a schedule with more granularity. For example, you can schedule a workflow to trigger at 9.30am every Monday, Wednesday, and Friday, but only between January and September:

CronValue
Minutes30
Hours9
Day of month*
Month1-9
Day of week1,3,5

Cron scheduleCron schedule

Webhook

Select the Webhook trigger to configure a workflow to run in response to webhook events. This trigger is useful if you need a workflow to run in response to a specific webhook event, such as a service monitoring alert or when a payment is received.

❗️

Any request sent to the webhook endpoint will trigger a workflow that is configured for webhooks. Do not share or publicize this information.

Every workflow has a unique webhook endpoint URL for receiving events. Use this URL when configuring webhook notifications from other services (e.g., Datadog or Stripe).

Copy the Example cURL to manually invoke the webhook trigger as you build and test your workflow. This includes the endpoint URL to use.
Webhook triggerWebhook trigger

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.