Workflow Triggers | Appsmith - SolFind Web Lens

Workflow Triggers | Appsmith

https://docs.appsmith.com/workflows/reference/workflow-triggers • 49 KB fetched
Open original page

Workflow Triggers | Appsmith

Ask AI
Search

Ask Appsmith AI Submit message

Examples How do I install Appsmith using Docker? How do I connect to my local PostgreSQL database? How do I pass inputs from a widget to a query? How do I trigger multiple queries conditionally? How do I fix the error: This value does not evaluate to type Array<Object>?

Try Appsmith

* Get Started

* Introduction

* Build Your First App

* Self Hosting

* New Installation Guides

* Manage Installation

* Upgrade Installation Guides

* Concepts

* Connect Data

* Overview

* How-to Guides

* Reference

* Datasources

* Query Settings

* Concepts

* Build Apps

* Overview

* Quickstart

* How-to Guides

* Reference

* Widgets

* Accessibility

* Theme

* Sample Apps

* Write Code

* Overview

* How-to Guides

* Reference

* Global Objects

* Global Functions

* JS Libraries

* Fetch API

* Data Transformation

* JavaScript Settings

* Concepts

* Best Practices

* Manage Apps and Users

* Authentication

* Granular Access Control

* Versioning with Git

* Setup SCIM Provisioning

* Embed Appsmith

* Migrate Applications

* Audit Logs

* Branding

* External Client Portal

* Packages

* Overview

* Tutorial

* How-to Guides

* Reference

* Package Version Control

* GIT Apps with Packages Best Practices

* Code Packages

* UI Packages

* Workflows

* Overview

* Tutorial

* How-to Guides

* Reference

* Workflow Triggers

* Workflow Queries

* Workflow Functions

* Pass Parameters to Workflows

* Run History

* Troubleshooting

* Overview

* Self-hosting Errors

* Application Errors

* Product

* FAQ

* Security

* Telemetry

* Support at Appsmith

* Privacy Policy

* Release Notes

* Contribute

* Workflows

* Reference

* Workflow Triggers
On this page
Workflow Triggers
Business

Workflow triggers start workflow runs based on specific conditions or events. This page provides information about the workflow triggers available in Appsmith, including their configurations, parameters, and usage examples.

Webhook trigger

A webhook trigger allows external services to start a workflow by sending a POST request to a specific URL. This trigger is useful for integrating with applications and services that can send HTTP requests when certain events occur. For example, you can set up a webhook trigger to automatically start a workflow whenever a user signs up on your website, allowing you to send a welcome email or update a database in real time.

Enable webhook trigger

Toggle the switch to enable the webhook trigger. Once enabled, Appsmith generates a unique identifier URL for the workflow.

URL

The unique webhook endpoint used to trigger the workflow. This URL includes an embedded API key for authentication and must be used in an external service’s HTTP POST request to start the workflow. The embedded API key can also be extracted and used as a Bearer token in the Authorization header.

If the original webhook URL is lost, you can generate a new one. This action invalidates the previous URL, and any external services or integrations must be updated to use the new endpoint.

Response Handling

Appsmith workflows can send a response back to the service that triggered the webhook. Use the appsmith.workflows.response() function to return an HTTP status code and a response body. This is helpful when the calling service expects a confirmation or a specific output after the workflow runs.

Example :
appsmith . workflows . response ( { statusCode : 200 ,
body : {
text : data ,
} ,
} ) ;

Scheduled trigger

A scheduled trigger starts a workflow at specific times or regular intervals, making it useful for automating tasks that need to run on a fixed schedule. For example, you can set up a scheduled trigger to automatically send a daily report summarizing sales performance to the sales team.

Timezone

Select the appropriate timezone from the dropdown menu. The default value is the system's timezone, such as UTC+05:30 - Asia/Kolkata . Ensure that the selected timezone aligns with when the workflow runs.

Set schedule

The workflow schedule uses a standard 5-field cron expression to define when the workflow runs. To schedule a workflow, configure the fields— Minute , Hour , Day of Month , Month , and Day of Week .

You can use the following syntax in each field to configure the schedule:

*
Asterisk ( * ) : Allows you to include a wildcard that represents all possible values in a field. For example, when set for all fields, the expression ( * * * * * ) means the workflow runs every minute of every hour, on every day, in every month, and on every day of the week.

*
Comma ( , ) : Allows you to set more than one value in a field. For example, when set to 0,30 in Minute and an asterisk for the others, the expression ( 0,30 * * * * ) means the workflow runs at minute 0 and 30 of every hour.

*
Hyphen ( - ) : Allows you to define a range of values in a field. For example, when set to 0 in Minute , 1-5 in Hour , and an asterisk for the others, the expression ( 0 1-5 * * * ) means the workflow runs every hour from 1 AM to 5 AM .

*
Slash ( / ) : Used to specify intervals for a field. For example, when set to */5 in Minute and an asterisk for the others, the expression ( */5 * * * * ) means the workflow runs every 5 minutes, starting from minute 0 and running at 5, 10, 15, and so on.

Popular cron expressions

Schedule Cron expression Minute Hour Day of Month Month Day of Week
Every minute * * * * * * * * * *
Every hour at minute 0 0 * * * * 0 * * * *
Every day at noon 0 12 * * * 0 12 * * *
Every Sunday at midnight 0 0 * * 0 0 0 * * 0

For more help with generating cron expressions, you can use the Appsmith Cron App .

Save schedule

After configuring the schedule, click the Save Schedule button to confirm your changes.

Enable scheduled trigger

Once you have saved the schedule, toggle the Schedule Trigger switch to enable it. This ensures that your workflow runs at the specified times or intervals.

Workflow Triggers | Appsmith

Links found on this page