Skip to main content
Version: v2.x

Create a Scheduled Trigger


Scheduled Triggers are used to reliably trigger HTTP endpoints to run custom business logic periodically based on a cron schedule. For example, you can create a Scheduled Trigger to generate an end-of-day sales report every weekday at 10pm.

To add a Scheduled Trigger, follow these steps:

Step 1: Define the Scheduled Trigger

The following fields are required to define a Scheduled Trigger:

  • Name: A name for the Scheduled Trigger.
  • Webhook: The HTTP endpoint that should be triggered.
  • Cron schedule: A cron expression defining the schedule for the cron. Cron events are created based on the UTC timezone. You can use tools like crontab guru to help build a cron expression.
  • Payload: The JSON payload which will be sent to the webhook.

You can also define a comment that helps you identify the Scheduled Trigger.

For example, we can create a Scheduled Trigger called eod_reports, to trigger the webhook with the cron schedule 0 22 * * 1-5, which means "At 22:00 on every day-of-week from Monday through Friday" (you can check this here).

Navigate to Events > Cron Triggers > Create in your Hasura Console.

Adding a Scheduled Trigger

In the form opened, fill out the fields defined above:

You can use the link next to the Cron Schedule field to help build a cron expression using crontab guru, or use the Frequently used crons dropdown as a shortcut.

Defining a Scheduled Trigger

Step 2: Define advanced options (Optional)

If you like, you can also define the following values:

  • Headers: List of headers to be sent to the webhook.
  • Retry configuration: In case the call to the webhook fails.
  • Include in metadata: When set to true, the Scheduled Trigger will be included in the metadata and can be exported along with it.

Expand the Advanced section.

Defining advanced options for a Scheduled Trigger

Schedule & logs

Once you've created your Scheduled Trigger, you can see Pending events, Processed events, and Invocation logs in their respective tabs.

Schedule and logs for Scheduled Triggers

Rest Connectors

REST Connectors i.e. request and response transformations, for Scheduled Triggers are used to invoke existing or third-party webhooks without needing any middleware or modifications to the upstream code.

REST Connectors modify the Scheduled Trigger's HTTP request to adapt to your webhook's expected format by adding suitable transforms.

Rest Connectors for Scheduled Triggers can be configured in the same way as rest connectors for event triggers. You can read more about it in the REST Connectors section.