Monday Trigger

Monday Trigger
Certified
Trigger a flow when items on a Monday board are created or updated

Polls items_page for the board, ordered by __last_updated__ descending, and emits an execution when one or more items have an updated_at strictly newer than now - interval (with a 1-minute overlap buffer to absorb clock drift). Fetches up to 100 items per evaluation; if the board is very active, decrease the interval or use items.Query with STORE mode for full coverage.

yaml
type: io.kestra.plugin.monday.items.Trigger

Examples

Run a flow whenever items on a board change

yaml
id: monday_items_trigger
namespace: company.team

tasks:
  - id: log
    type: io.kestra.plugin.core.log.Log
    message: "Found {{ trigger.count }} updated items"

triggers:
  - id: items
    type: io.kestra.plugin.monday.items.Trigger
    apiToken: "{{ secret('MONDAY_API_TOKEN') }}"
    boardId: "1234567890"
    interval: PT1M

Properties

apiToken *string

Monday API token

Personal API v2 token. Generate it in Monday under Profile, Developers, My Access Tokens. Treat the token as a secret and prefer Kestra secrets, e.g. {{ secret('MONDAY_API_TOKEN') }}.

boardId *string

Board id to watch

allowConcurrent boolean

Defaultfalse

Specifies whether a trigger is allowed to start a new execution even if a previous run is still in progress.

apiUrl string

Defaulthttps://api.monday.com/v2

Monday GraphQL endpoint

Override only for proxies or test fixtures (WireMock).

apiVersion string

Default2024-10

Monday API version header

Sent as the API-Version header. See the Monday API versioning docs.

groupId string

Optional group id filter

interval string

DefaultPT5M

Formatduration

Polling interval

maxRetries integerstring

Default3

Maximum retry attempts

Number of attempts before giving up on transient Monday API errors (HTTP 429, COMPLEXITY_BUDGET_EXHAUSTED).

retryInterval string

DefaultPT5S

Initial retry interval

Base wait between retry attempts. Doubles each attempt up to maxRetryInterval.

retryMaxInterval string

DefaultPT30S

Maximum retry interval

Cap on the exponentially-growing retry delay.

stopAfter array

SubTypestring

Possible Values

CREATEDSUBMITTEDRUNNINGPAUSEDRESTARTEDKILLINGSUCCESSWARNINGFAILEDKILLEDCANCELLEDQUEUEDRETRYINGRETRIEDSKIPPEDBREAKPOINTRESUBMITTED

List of execution states after which a trigger should be stopped (a.k.a. disabled).

when string

Defaulttrue

A condition that determines whether the trigger should run.

A Pebble expression evaluated at trigger time. The trigger fires only when the expression evaluates to a truthy value (true, a non-empty string, a non-zero number). Use this to gate trigger execution on dynamic runtime values such as execution labels, flow variables, or environment conditions.

Outputs

count integer

Number of items returned

items array

SubTypeobject

Items changed since the previous evaluation