Monday Create

Monday Create

Certified

Send a notification to a Monday user

Send a notification to a Monday user. Uses the Monday.com GraphQL API.

yaml
type: io.kestra.plugin.monday.notifications.Create

Notify a user about an item update

yaml
id: monday_create_notification
namespace: company.team

tasks:
  - id: notify
    type: io.kestra.plugin.monday.notifications.Create
    apiToken: "{{ secret('MONDAY_API_TOKEN') }}"
    userId: "12345"
    targetId: "67890"
    text: "Item updated by the pipeline."
    targetType: Project
Properties

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') }}.

Target id

Item id when targetType is Project, or update id when targetType is Post.

Notification body text

Recipient user id

Defaulthttps://api.monday.com/v2

Monday GraphQL endpoint

Override only for proxies or test fixtures (WireMock).

Default2024-10

Monday API version header

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

Default3

Maximum retry attempts

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

DefaultPT5S

Initial retry interval

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

DefaultPT30S

Maximum retry interval

Cap on the exponentially-growing retry delay.

DefaultPROJECT
Possible Values
PROJECTPOST

Target type

One of Project (item) or Post (update). Note: Monday uses the name Project to refer to an item in this API.