SDK trigger limits

Workato enforces specific limits on SDK triggers to optimize performance and ensure system stability. We apply limits to the following trigger processing functions:

• Consecutive polling in a single poll cycle when no jobs are produced
• The number of events per poll

Consecutive polls in a single poll cycle without jobs

Triggers can poll consecutively to retrieve valid results. The can_poll_more boolean attribute in the SDK trigger poll response controls this behavior. Workato enforces a limit on consecutive polls in a single poll cycle when no jobs are produced.

Throttling mechanism

Workato throttles a trigger if it polls consecutively without producing any jobs. Throttling minimizes unnecessary polling and ensures system stability. Triggers are limited to 600 consecutive polls in a single poll cycle without jobs before Workato pauses polling for 5 minutes. This threshold gradually decreases over time to 50 consecutive polls.

Workato pauses polling for 5 minutes when your trigger exceeds this limit. Polling resumes after the pause automatically and the counter continues from where it left off. Workato pauses polling again for another 5 minutes if the next poll also produces no jobs. The counter resets to zero if a poll produces jobs.

This pattern repeats until the poll cycle ends when can_poll_more equals false. Triggers can only poll once every 5 minutes without producing jobs after reaching the limit.

Throttling notification

Workato sends email notifications automatically when a recipe is throttled. These notifications provide relevant details and keep you informed about throttled recipes.

Throttling notification recipients

Workato sends the following notifications about throttled recipes to specific recipients based on their role:

• Workspace admins: notifications are sent directly to the admin of the workspace where the recipe runs.
• Embedded partners: notifications are sent to the Embedded partner’s workspace email. Embedded customers do not receive these notifications.

Throttling notification details

Workato provides notifications at two key points to keep you informed about throttled recipes. Workato sends an email that contains details about the throttling event when a recipe is throttled for the first time. This ensures you are immediately aware of any issues affecting your recipes.

Additionally, at the end of each month, Workato sends a summary email that lists all recipes throttled during that month. This email provides a comprehensive overview of throttled recipes and serves as a reminder.

Number of events per poll

A large number of events can be fetched in a single poll. This is usually defined as the page_size in triggers. Workato enforces a limit on the number of events that can be fetched in a single poll.

Limited event polls

Workato stops a recipe if the trigger fetches an excessive number of events in a single poll. This prevents system overload and ensures stability. Starting June 9th, 2025, triggers are limited to 1000 events in a single poll. The recipe is stopped if your trigger exceeds this limit.

Limited event polling notification

Workato sends email notifications automatically when a recipe is stopped. These notifications provide relevant details and keep you informed about affected recipes.

Limited event polling notification recipients

The following Limited event polling notifications are sent to specific recipients based on their role:

• Workspace admins: notifications are sent directly to the admin of the workspace where the recipe runs.
• Embedded partners: notifications are sent to the Embedded partner’s workspace email. Embedded customers do not receive these notifications.

Limited event polling notification details

Workato provides notifications at two key points to keep you informed about stopped recipes due to the limit.

Workato sends an email that contains information about the recipe when a recipe is stopped for the first time. This ensures you are immediately aware of issues affecting your recipe.

Additionally, Workato sends a end-of-the-month summary email that lists all affected recipes. This email provides a comprehensive overview of affected recipes and serves as a reminder.