Monday Create

Monday Create

Certified

Create a folder inside a Monday workspace

Create a folder inside a Monday workspace. Uses the Monday.com GraphQL API.

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

Create a folder in a workspace

yaml
id: monday_create_folder
namespace: company.team

tasks:
  - id: create
    type: io.kestra.plugin.monday.folders.Create
    apiToken: "{{ secret('MONDAY_API_TOKEN') }}"
    name: "Campaigns"
    workspaceId: "1234567890"
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') }}.

Folder name

Workspace id that owns the folder

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.

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.

Definitions
assetFailureBehaviorstring
Possible Values
IGNOREFAILWARN

Asset 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.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

id*string
Min length1
typestring
outputs

The assets produced as outputs.

id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*object
descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
id*string
Min length1
Max length150
type*string
Min length1

Custom asset type

descriptionstring
displayNamestring
metadataobject
Default{}
namespacestring
Min length1
Max length150
Possible Values
DONE_GREENWORKING_ORANGEDARK_REDDARK_PURPLEDARK_ORANGEBRIGHT_BLUEBRIGHT_GREENPURPLECHILI_BLUELIPSTICKAQUAMARINEINDIGOSOFIA_PINKSTUCK_REDSUNSET

Folder color

Monday accepts the uppercase enum name, e.g. DONE_GREEN, BRIGHT_BLUE, PURPLE. See FolderColor for all available values.

Default3

Maximum retry attempts

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

Parent folder id for nested folders

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.