Create Subitem
monday.create_subitem
ActionBusiness appsconnection required
Calls the monday.com API with the connection's credentials.
Create a subitem under an existing item.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- Monday.com
- Secret shape
- the monday.com API token, or {"token": "…"}
- Config it needs
- api_version
- Resolved by
- config.connection_id, else node.connection_id
Configuration
4 fields, 2 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
parent_item_id The parent item's id. | string | Yes | — | — | — |
item_name The new subitem's name. | string | Yes | — | — | — |
column_values A JSON object keyed by column id — e.g. {"text": "hi", "status": {"label": "Done"}, "date4": {"date": "2026-06-15"}}. Per type: text → "any text"; long_text → {"text": "any text"}; number → "42.5" (a string, not a bare number); status → {"label": "Done"} or {"index": 1} (index is the label id); date → {"date": "2026-06-15", "time": "09:00:00"} (time optional, UTC); people → {"personsAndTeams": [{"id": 12345678, "kind": "person"}]}; dropdown → {"labels": ["Marketing"]} or {"ids": [1, 2]}; link → {"url": "https://example.com", "text": "Example"}; email → {"email": "a@example.com", "text": "a@example.com"} (both required); phone → {"phone": "+12025550169", "countryShortName": "US"}; checkbox → {"checked": "true"}. It is sent as monday's JSON-encoded string for you. | object | No | — | — | — |
create_labels_if_missing Create a status or dropdown label that does not exist yet instead of failing. | boolean | No | — | — | — |
Output
One shape.
result
| Field | Type | Example |
|---|---|---|
ok True when monday.com created the subitem. | boolean | — |
item_id The new subitem's id. | string | — |
name The new subitem's name. | string | — |
subitem The new subitem, including the board it landed on. | object | — |
{
"item_id": "",
"name": "",
"ok": false,
"subitem": {}
}Notes
- Subitems live on the parent board's hidden subitems board, so column ids in column_values are that board's — not the parent board's.
See Create Subitem run in a workflow.
In a technical demo we add the Monday.com connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.