createCard( )

Deprecated. This function is being discontinued in the upcoming months. We are working to provide alternatives, and we'll provide timely updates before implementing any changes. We understand that this transition might present challenges, and we appreciate your patience and understanding.

Creates a new workflow card.

The createCard() function returns a Promise that resolves to the created card's ID when the card is created in the specified workflow phase.

Pass a value for the position parameter to specify the newly created card's position within the specified phase. Positions are zero-based, meaning the first position is0. When omitted, the newly created card is added to the specified phase as the top card within the phase.

This function requires you to specify the ID of a workflow and phase. To learn about retrieving IDs in the Workflow API, see Retrieving IDs.

Note: Each workflow is limited to 5,000 cards. If this limit is reached, createCard() throws an error. Archive cards when they're no longer needed to reduce card count and avoid hitting the limit.

Method Declaration
Method Parameters

ID of the workflow to create the card in.


ID of the phase to create the card in.


Card to create.


The created card's position within the workflow.

Return Type:Promise<string>
Was this helpful?