Monday Create
CertifiedCreate a webhook on a Monday board
Monday Create
Create a webhook on a Monday board
Create a webhook on a Monday board. Uses the Monday.com GraphQL API.
type: io.kestra.plugin.monday.webhooks.CreateExamples
Subscribe to new item events
id: monday_create_webhook
namespace: company.team
tasks:
- id: create
type: io.kestra.plugin.monday.webhooks.Create
apiToken: "{{ secret('MONDAY_API_TOKEN') }}"
boardId: "1234567890"
url: "https://example.com/webhook"
event: create_item
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 subscribe on
event *string
INCOMING_NOTIFICATIONCHANGE_COLUMN_VALUECHANGE_STATUS_COLUMN_VALUECREATE_ITEMITEM_ARCHIVEDITEM_DELETEDITEM_MOVED_TO_ANY_GROUPITEM_MOVED_TO_SPECIFIC_GROUPITEM_RESTOREDCREATE_SUBITEMCHANGE_SUBITEM_COLUMN_VALUECHANGE_NAMEUPDATE_COLUMN_VALUECHANGE_SUBITEM_NAMEMOVE_SUBITEMSUBITEM_ARCHIVEDSUBITEM_DELETEDCREATE_COLUMNCREATE_UPDATEEDIT_UPDATEDELETE_UPDATECREATE_SUBITEM_UPDATEWebhook event
One of Monday's documented event types, e.g. create_item, change_column_value,
change_status_column_value, item_archived, item_deleted, item_moved_to_any_group,
create_subitem, create_update, edit_update, delete_update.
url *string
Target URL that will receive POST callbacks
apiUrl string
https://api.monday.com/v2Monday GraphQL endpoint
Override only for proxies or test fixtures (WireMock).
apiVersion string
2024-10Monday API version header
Sent as the API-Version header. See the Monday API versioning docs.
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150config object
Extra event configuration
Serialized to a JSON string for events that require it. For example, change_status_column_value uses: {"columnId": "status", "columnValue": {"index": 1}}.
maxRetries integerstring
3Maximum retry attempts
Number of attempts before giving up on transient Monday API errors (HTTP 429, COMPLEXITY_BUDGET_EXHAUSTED).
retryInterval string
PT5SInitial retry interval
Base wait between retry attempts. Doubles each attempt up to maxRetryInterval.
retryMaxInterval string
PT30SMaximum retry interval
Cap on the exponentially-growing retry delay.
