Workflow Triggers

Every workflow comes with a webhook URL that can be used to trigger the workflow. To activate the webhook, click on the Trigger node and toggle the webhook switch.

In the previous tutorials, we’ve used the manual trigger UI to run the workflow. To start receiving external events via the webhook URL, you still need to enable the workflow.

Click on Enable workflow to start receiving external events.

To trigger the workflow, send a POST request to the webhook URL with the following JSON payload:

{
    "url": "https://example.com"
}

Let’s say you want to the JSON payload to the webhook to fit a specific schema. Even though the input schema is optional, specifying it will allow you to validate the payload of the incoming webhook request. The workflow will fail fast if the incoming payload does not match the schema.

You can define the input schema by going into the workflow settings and filling out the Input Schema config with the following:

url:
    type: str
    description: The URL to check if malicious

field:
    type: str | int | bool | list[type] | dict[str, type]
    description: The description of the field
    default: The default value of the field (optional)

You can schedule a workflow under the Trigger node’s Schedules section.

After creating a schedule, you’ll need to click Enable workflow to start workflow runs on the schedule.