
Monday Create
CertifiedCreate an item on a Monday board
Monday Create
Create an item on a Monday board
Calls the create_item mutation. columnValues accepts a structured map and is
encoded as a JSON string before being sent, matching Monday's JSON-in-JSON
column values contract.
type: io.kestra.plugin.monday.items.CreateExamples
Create a simple item with a status and date column
id: monday_create_item
namespace: company.team
tasks:
- id: create
type: io.kestra.plugin.monday.items.Create
apiToken: "{{ secret('MONDAY_API_TOKEN') }}"
boardId: "1234567890"
itemName: "New lead"
columnValues:
status: { label: "Working on it" }
date4: { date: "2025-01-01" }
Properties
apiToken *Requiredstring
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 *Requiredstring
Target board id
itemName *Requiredstring
Item name
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.
columnValues object
Column values
Map of column id to column value object. Serialized to JSON.
createLabelsIfMissing booleanstring
falseCreate new label entries on status/dropdown columns when missing
groupId string
Group id where the item is created
Optional. Defaults to the board's top group.
maxRetries integerstring
3Maximum retry attempts
Number of attempts before giving up on transient Monday API errors (HTTP 429, COMPLEXITY_BUDGET_EXHAUSTED).
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
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.