Create Card
wekan.create_card
ActionBusiness appsconnection required
Calls the Wekan API with the connection's credentials.
Create a card in a board's list and swimlane.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- Bearer token
- Providers
- Wekan
- Secret shape
- the Wekan API token as {"token": "…"}, or {"username": "…", "password": "…"} to log in with
- Config it needs
- base_url, user_id
- Resolved by
- config.connection_id, else node.connection_id
Configuration
12 fields, 4 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 |
|---|---|---|---|---|---|
board_id Wekan's id for the board. It is the long identifier in the board URL, not its title. | string | Yes | — | — | wJmnfd4bLLYAoRcS2 |
list_id Wekan's id for the list (the board column), as returned by wekan.list_lists. | string | Yes | — | — | wJmnfd4bLLYAoRcS2 |
swimlane_id Id of the swimlane the card belongs to. Every Wekan card sits in one, and a new board's is named Default. | string | Yes | — | — | wJmnfd4bLLYAoRcS2 |
title The card's title, shown on the board. | string | Yes | — | — | Investigate the retry loop |
description The card's description, written as Markdown. | string | No | — | — | — |
author_id Id of the user to record as the card's author. Wekan 8.19 and later ignore this and attribute the card to the connection's own user; it is only sent for older instances that require it. | string | No | — | — | — |
members Ids of the board members to put on the card, separated by commas. Wekan accepts only users who are active members of this board. | string | No | — | — | — |
assignees Ids of the board members to assign the card to, separated by commas. Wekan accepts only users who are active members of this board. | string | No | — | — | — |
received_at The card's received date, as an ISO-8601 timestamp. | string | No | — | iso8601 format | — |
start_at The card's start date, as an ISO-8601 timestamp. | string | No | — | iso8601 format | — |
due_at The card's due date, as an ISO-8601 timestamp. | string | No | — | iso8601 format | — |
end_at The card's end date, as an ISO-8601 timestamp. | string | No | — | iso8601 format | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"board_id": "wJmnfd4bLLYAoRcS2",
"list_id": "wJmnfd4bLLYAoRcS2",
"swimlane_id": "wJmnfd4bLLYAoRcS2",
"title": "Investigate the retry loop"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
_id The id Wekan gave the new record. | string | — |
{
"_id": ""
}See Create Card run in a workflow.
In a technical demo we add the Wekan connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.