Trello

Manage Trello boards, cards, lists, labels, checklists, attachments, members, and comments.

Overview

Trello is a collaboration tool that organizes projects into kanban boards. This tool provides full CRUD operations for boards, cards, lists, labels, checklists, attachments (URL-based), board members, and card comments via the Trello REST API. Authentication uses API key + token passed as query parameters.

Category: Productivity
Tool Name: trello
Version: 1

Appearance: Icon: si-trello | Color: #0079BF

Node Type

Action — processes input items and produces output

Input / Output

Direction	Port(s)
Input	Input
Output	Output, Error

Credentials

This tool requires Trello API credentials. See the Credentials Guide for setup instructions.

Resources

Resource	Value
Attachment	attachment
Board	board
Board Member	boardMember
Card	card
Card Comment	cardComment
Checklist	checklist
Label	label
List	list

Operations

Board (board)

Operation	Value	Description
Create	create	Create a new board
Delete	delete	Delete a board
Get	get	Get the data of a board
Update	update	Update a board

Board Member (boardMember)

Operation	Value	Description
Add	add	Add member to board using member ID
Get Many	getAll	Get many members of a board
Invite	invite	Invite a new member to a board via email
Remove	remove	Remove member from board using member ID

Card (card)

Operation	Value	Description
Create	create	Create a new card
Delete	delete	Delete a card
Get	get	Get the data of a card
Update	update	Update a card

Card Comment (cardComment)

Operation	Value	Description
Create	create	Create a comment on a card
Delete	delete	Delete a comment from a card
Update	update	Update a comment on a card

Checklist (checklist)

Operation	Value	Description
Create	create	Create a new checklist
Create Checklist Item	createCheckItem	Create a checklist item
Delete	delete	Delete a checklist
Delete Checklist Item	deleteCheckItem	Delete a checklist item
Get	get	Get the data of a checklist
Get Checklist Items	getCheckItem	Get a specific checklist item on a card
Get Completed Checklist Items	completedCheckItems	Get the completed checklist items on a card
Get Many	getAll	Get many checklists for the card
Update Checklist Item	updateCheckItem	Update an item in a checklist on a card

Label (label)

Operation	Value	Description
Add to Card	addLabel	Add a label to a card
Create	create	Create a new label
Delete	delete	Delete a label
Get	get	Get the data of a label
Get Many	getAll	Get many labels for the board
Remove From Card	removeLabel	Remove a label from a card
Update	update	Update a label

List (list)

Operation	Value	Description
Archive	archive	Archive/Unarchive a list
Create	create	Create a new list
Get	get	Get the data of a list
Get Cards	getCards	Get all the cards in a list
Get Many	getAll	Get many lists
Update	update	Update a list

Attachment (attachment)

Operation	Value	Description
Create	create	Create a new attachment for a card (URL only)
Delete	delete	Delete an attachment
Get	get	Get the data of an attachment
Get Many	getAll	Get many attachments for the card

Parameters

Board: Create

Parameter	Type	Required	Default	Description
Name (name)	string	Yes	—	The name of the board
Description (description)	string	No	—	The description of the board
Additional Fields (additionalFields)	collection	No	{}	Optional board settings applied when the board is created.
— Aging	options	No	regular	Type of card aging if enabled
				Options: pirate, regular
— Background	string	No	blue	The ID of a custom background or one of: blue, orange, green, red, purple, pink, lime, sky, grey
— Comments	options	No	members	Who can comment on cards on this board
				Options: disabled, members, observers, org (organization members), public
— Covers	boolean	No	true	Whether card covers are enabled
— Invitations	options	No	members	Who can invite users to join
				Options: admins, members
— Keep From Source	string	No	none	To keep cards from the original board pass in the value cards
— Labels	boolean	No	true	Whether to use the default set of labels
— Lists	boolean	No	true	Whether to add the default set of lists (To Do, Doing, Done). Ignored if idBoardSource is provided.
— Organization ID	string	No	—	The ID or name of the team the board should belong to
— Permission Level	options	No	private	The permissions level of the board
				Options: org (organization members), private, public
— Power Ups	options	No	all	Power-Ups to enable on the new board
				Options: all, calendar, cardAging, recap, voting
— Self Join	boolean	No	true	Whether users can join the board without invitation
— Source IDs	string	No	—	The ID of a board to copy into the new board
— Voting	options	No	disabled	Who can vote on this board
				Options: disabled, members, observers, org (organization members), public

Board: Delete

Parameter	Type	Required	Default	Description
Board ID (id)	string	Yes	—	The ID of the board. Find at the end of your board URL: https://trello.com/b/{boardId}/board-name. Supports expressions like {{ $json.boardId }}.

Board: Get

Parameter	Type	Required	Default	Description
Board ID (id)	string	Yes	—	The ID of the board. Find at the end of your board URL: https://trello.com/b/{boardId}/board-name. Supports expressions like {{ $json.boardId }}.
Additional Fields (additionalFields)	collection	No	{}	Optional fields controlling what the response contains.
— Fields	string	No	all	Fields to return. Either “all” or a comma-separated list: closed, dateLastActivity, dateLastView, desc, descData, idOrganization, invitations, invited, labelNames, memberships, name, pinned, powerUps, prefs, shortLink, shortUrl, starred, subscribed, URL.
— Plugin Data	boolean	No	false	Whether to include pluginData on the card with the response

Board: Update

Parameter	Type	Required	Default	Description
Board ID (id)	string	Yes	—	The ID of the board. Find at the end of your board URL: https://trello.com/b/{boardId}/board-name. Supports expressions like {{ $json.boardId }}.
Update Fields (updateFields)	collection	No	{}	The board properties to change. Only the fields you add are sent.
— Closed	boolean	No	false	Whether the board is closed
— Description	string	No	—	New description of the board
— Name	string	No	—	New name of the board
— Organization ID	string	No	—	The ID of the team the board should be moved to
— Subscribed	boolean	No	false	Whether the acting user is subscribed to the board

Board Member: Add

Parameter	Type	Required	Default	Description
Board ID (id)	string	Yes	—	The ID of the board to add member to
Member ID (idMember)	string	Yes	—	The ID of the member to add to the board
Type	options	Yes	normal	The type of membership the user being added should have
				Options: normal (invite as normal member), admin (invite as admin), observer (invite as observer — a Trello premium feature)
Additional Fields (additionalFields)	collection	No	{}	Optional settings applied when the member is added.
— Allow Billable Guest	boolean	No	false	Whether to allow organization admins to add multi-board guests onto a board

Board Member: Get Many

Parameter	Type	Required	Default	Description
Board ID (id)	string	Yes	—	The ID of the board to get members from
Return All (returnAll)	boolean	No	false	Whether to return all results or only up to a given limit
Limit (limit)	number	No	20	Max number of results to return (shown when Return All is false)

Board Member: Invite

Parameter	Type	Required	Default	Description
Board ID (id)	string	Yes	—	The ID of the board to invite member to
Email	string	Yes	—	The email of the member to invite. Supports expressions like {{ $json.email }}.
Additional Fields (additionalFields)	collection	No	{}	Optional details applied to the invitation.
— Type	options	No	normal	The membership type
				Options: normal, admin, observer
— Full Name	string	No	—	The full name of the user to add as a member. Must have a length of at least 1 and cannot begin nor end with a space.

Board Member: Remove

Parameter	Type	Required	Default	Description
Board ID (id)	string	Yes	—	The ID of the board to remove member from
Member ID (idMember)	string	Yes	—	The ID of the member to remove from the board

Card: Create

Parameter	Type	Required	Default	Description
List ID (listId)	string	Yes	—	The ID of the list to create the card in. Supports expressions like {{ $json.listId }}.
Name (name)	string	Yes	—	The name of the card
Description (description)	string	No	—	The description of the card
Additional Fields (additionalFields)	collection	No	{}	Optional card properties applied when the card is created.
— Due Date	dateTime	No	—	A due date for the card
— Due Complete	boolean	No	false	Whether the card is completed
— Position	string	No	bottom	The position of the new card. top, bottom, or a positive float.
— Member IDs	string	No	—	Comma-separated list of member IDs to add to the card
— Label IDs	string	No	—	Comma-separated list of label IDs to add to the card
— URL Source	string	No	—	A source URL to attach to card
— Source ID	string	No	—	The ID of a card to copy into the new card
— Keep From Source	string	No	all	If using idCardSource, which properties to copy: all or comma-separated list of: attachments, checklists, comments, due, labels, members, stickers.

Card: Delete

Parameter	Type	Required	Default	Description
Card ID (id)	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name. Supports expressions like {{ $json.cardId }}.

Card: Get

Parameter	Type	Required	Default	Description
Card ID (id)	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name. Supports expressions like {{ $json.cardId }}.
Additional Fields (additionalFields)	collection	No	{}	Optional fields controlling what the response contains.
— Fields	string	No	all	Fields to return. Either “all” or a comma-separated list: badges, checkItemStates, closed, dateLastActivity, desc, descData, due, email, idBoard, idChecklists, idLabels, idList, idMembers, idShort, idAttachmentCover, manualCoverAttachment, labels, name, pos, shortUrl, url.
— Board	boolean	No	false	Whether to return the board object the card is on
— Board Fields	string	No	all	Fields to return for the board. Either “all” or a comma-separated list.
— Custom Field Items	boolean	No	false	Whether to include the customFieldItems
— Members	boolean	No	false	Whether to return member objects for members on the card
— Member Fields	string	No	all	Fields to return for members. Either “all” or comma-separated list: avatarHash, fullName, initials, username.
— Plugin Data	boolean	No	false	Whether to include pluginData on the card with the response
— Stickers	boolean	No	false	Whether to include sticker models with the response
— Sticker Fields	string	No	all	Fields to return for stickers. Either “all” or a comma-separated list.

Card: Update

Parameter	Type	Required	Default	Description
Card ID (id)	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name. Supports expressions like {{ $json.cardId }}.
Update Fields (updateFields)	collection	No	{}	The card properties to change. Only the fields you add are sent.
— Attachment Cover	string	No	—	The ID of the image attachment the card should use as its cover, or null for none
— Board ID	string	No	—	The ID of the board the card should be on
— Closed	boolean	No	false	Whether the card is archived
— Description	string	No	—	New description of the card
— Due Date	dateTime	No	—	A due date for the card
— Due Complete	boolean	No	false	Whether the card is completed
— Label IDs	string	No	—	Comma-separated list of label IDs to set on card
— List ID	string	No	—	The ID of the list the card should be in
— Member IDs	string	No	—	Comma-separated list of member IDs to set on card
— Name	string	No	—	New name of the card
— Position	string	No	bottom	The position of the card. top, bottom, or a positive float.
— Subscribed	boolean	No	false	Whether the acting user is subscribed to the card

Card Comment: Create

Parameter	Type	Required	Default	Description
Card ID (cardId)	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name. Supports expressions like {{ $json.cardId }}.
Text (text)	string	Yes	—	Text of the comment. Supports expressions like {{ $json.message }}.

Card Comment: Delete

Parameter	Type	Required	Default	Description
Card ID (cardId)	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name. Supports expressions like {{ $json.cardId }}.
Comment ID (commentId)	string	Yes	—	The ID of the comment to delete

Card Comment: Update

Parameter	Type	Required	Default	Description
Card ID (cardId)	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name. Supports expressions like {{ $json.cardId }}.
Comment ID (commentId)	string	Yes	—	The ID of the comment to update
Text (text)	string	Yes	—	New text of the comment

Checklist: Create

Parameter	Type	Required	Default	Description
Card ID (cardId)	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name. Supports expressions like {{ $json.cardId }}.
Name (name)	string	Yes	—	The name of the checklist
Additional Fields (additionalFields)	collection	No	{}	Optional settings applied when the checklist is created.
— ID Of Checklist Source	string	No	—	The ID of a source checklist to copy into the new one
— Position	string	No	—	The position of the checklist on the card. One of: top, bottom, or a positive number.

Checklist: Create Checklist Item

Parameter	Type	Required	Default	Description
Checklist ID (checklistId)	string	Yes	—	The ID of the checklist to add item to
Name (name)	string	Yes	—	The name of the new check item on the checklist
Additional Fields (additionalFields)	collection	No	{}	Optional settings applied when the checklist item is created.
— Checked	boolean	No	false	Whether the check item is already checked when created
— Position	string	No	—	The position of the checklist on the card. One of: top, bottom, or a positive number.

Checklist: Delete

Parameter	Type	Required	Default	Description
Card ID (cardId)	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name. Supports expressions like {{ $json.cardId }}.
Checklist ID (id)	string	Yes	—	The ID of the checklist to delete

Checklist: Delete Checklist Item

Parameter	Type	Required	Default	Description
Card ID (cardId)	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name. Supports expressions like {{ $json.cardId }}.
CheckItem ID (checkItemId)	string	Yes	—	The ID of the checklist item to delete

Checklist: Get

Parameter	Type	Required	Default	Description
Checklist ID (id)	string	Yes	—	The ID of the checklist to get
Additional Fields (additionalFields)	collection	No	{}	Optional fields controlling what the response contains.
— Fields	string	No	all	Fields to return. Either “all” or a comma-separated list of fields.

Checklist: Get Checklist Items

Parameter	Type	Required	Default	Description
Card ID (cardId)	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name. Supports expressions like {{ $json.cardId }}.
CheckItem ID (checkItemId)	string	Yes	—	The ID of the checklist item to get
Additional Fields (additionalFields)	collection	No	{}	Optional fields controlling what the response contains.
— Fields	string	No	all	Fields to return. Either “all” or a comma-separated list of fields.

Checklist: Get Completed Checklist Items

Parameter	Type	Required	Default	Description
Card ID (cardId)	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name. Supports expressions like {{ $json.cardId }}.
Additional Fields (additionalFields)	collection	No	{}	Optional fields controlling what the response contains.
— Fields	string	No	all	Fields to return. Either “all” or a comma-separated list of: “idCheckItem”, “state”.

Checklist: Get Many

Parameter	Type	Required	Default	Description
Card ID (cardId)	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name. Supports expressions like {{ $json.cardId }}.
Additional Fields (additionalFields)	collection	No	{}	Optional fields controlling what the response contains.
— Fields	string	No	all	Fields to return. Either “all” or a comma-separated list of fields.

Checklist: Update Checklist Item

Parameter	Type	Required	Default	Description
Card ID (cardId)	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name. Supports expressions like {{ $json.cardId }}.
CheckItem ID (checkItemId)	string	Yes	—	The ID of the checklist item to update
Additional Fields (additionalFields)	collection	No	{}	The checklist item properties to change. Only the fields you add are sent.
— Name	string	No	—	The new name for the checklist item
— State	options	No	complete	The state of the checklist item
				Options: complete, incomplete
— Checklist ID	string	No	—	The ID of the checklist this item is in
— Position	string	No	—	The position of the checklist item. One of: top, bottom, or a positive number.

Label: Add to Card

Parameter	Type	Required	Default	Description
Card ID (cardId)	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name. Supports expressions like {{ $json.cardId }}.
Label ID (id)	string	Yes	—	The ID of the label to add or remove

Label: Create

Parameter	Type	Required	Default	Description
Board ID (boardId)	string	Yes	—	The ID of the board. Find at the end of your board URL: https://trello.com/b/{boardId}/board-name. Supports expressions like {{ $json.boardId }}.
Name (name)	string	Yes	—	Name for the label
Color	options	Yes	null	The color for the label
				Options: black, blue, green, lime, null (no color), orange, pink, purple, red, sky, yellow

Label: Delete

Parameter	Type	Required	Default	Description
Label ID (id)	string	Yes	—	The ID of the label

Label: Get

Parameter	Type	Required	Default	Description
Label ID (id)	string	Yes	—	The ID of the label
Additional Fields (additionalFields)	collection	No	{}	Optional fields controlling what the response contains.
— Fields	string	No	all	Fields to return. Either “all” or a comma-separated list of fields.

Label: Get Many

Parameter	Type	Required	Default	Description
Board ID (boardId)	string	Yes	—	The ID of the board. Find at the end of your board URL: https://trello.com/b/{boardId}/board-name. Supports expressions like {{ $json.boardId }}.
Additional Fields (additionalFields)	collection	No	{}	Optional fields controlling what the response contains.
— Fields	string	No	all	Fields to return. Either “all” or a comma-separated list of fields.

Label: Remove From Card

Parameter	Type	Required	Default	Description
Card ID (cardId)	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name. Supports expressions like {{ $json.cardId }}.
Label ID (id)	string	Yes	—	The ID of the label to add or remove

Label: Update

Parameter	Type	Required	Default	Description
Label ID (id)	string	Yes	—	The ID of the label
Update Fields (updateFields)	collection	No	{}	The label properties to change. Only the fields you add are sent.
— Name	string	No	—	Name of the label
— Color	options	No	null	The color for the label
				Options: black, blue, green, lime, null (no color), orange, pink, purple, red, sky, yellow

List: Archive

Parameter	Type	Required	Default	Description
List ID (id)	string	Yes	—	The ID of the list to archive or unarchive
Archive	boolean	No	false	Whether the list should be archived (true) or unarchived (false)

List: Create

Parameter	Type	Required	Default	Description
Board ID (idBoard)	string	Yes	—	The ID of the board the list should be created in. Supports expressions like {{ $json.boardId }}.
Name (name)	string	Yes	—	The name of the list
Additional Fields (additionalFields)	collection	No	{}	Optional settings applied when the list is created.
— List Source	string	No	—	ID of the list to copy into the new list
— Position	string	No	bottom	The position of the new list. top, bottom, or a positive float.

List: Get

Parameter	Type	Required	Default	Description
List ID (id)	string	Yes	—	The ID of the list to get
Additional Fields (additionalFields)	collection	No	{}	Optional fields controlling what the response contains.
— Fields	string	No	all	Fields to return. Either “all” or a comma-separated list of fields.

List: Get Cards

Parameter	Type	Required	Default	Description
List ID (id)	string	Yes	—	The ID of the list to get cards from
Return All (returnAll)	boolean	No	false	Whether to return all results or only up to a given limit
Limit (limit)	number	No	20	Max number of results to return (shown when Return All is false)
Additional Fields (additionalFields)	collection	No	{}	Optional fields controlling what the response contains.
— Fields	string	No	all	Fields to return. Either “all” or a comma-separated list of fields.

List: Get Many

Parameter	Type	Required	Default	Description
Board ID (id)	string	Yes	—	The ID of the board
Return All (returnAll)	boolean	No	false	Whether to return all results or only up to a given limit
Limit (limit)	number	No	20	Max number of results to return (shown when Return All is false)
Additional Fields (additionalFields)	collection	No	{}	Optional fields controlling what the response contains.
— Fields	string	No	all	Fields to return. Either “all” or a comma-separated list of fields.

List: Update

Parameter	Type	Required	Default	Description
List ID (id)	string	Yes	—	The ID of the list to update
Update Fields (updateFields)	collection	No	{}	The list properties to change. Only the fields you add are sent.
— Board ID	string	No	—	ID of a board the list should be moved to
— Closed	boolean	No	false	Whether the list is closed
— Name	string	No	—	New name of the list
— Position	string	No	bottom	The position of the list. top, bottom, or a positive float.
— Subscribed	boolean	No	false	Whether the acting user is subscribed to the list

Attachment: Create

Parameter	Type	Required	Default	Description
Card ID (cardId)	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name. Supports expressions like {{ $json.cardId }}.
Source URL	string	Yes	—	The URL of the attachment to add. Supports expressions like {{ $json.url }}.
Additional Fields (additionalFields)	collection	No	{}	Optional details applied when the attachment is created.
— MIME Type	string	No	—	The MIME type of the attachment
— Name	string	No	—	The name of the attachment

Attachment: Delete

Parameter	Type	Required	Default	Description
Card ID (cardId)	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name. Supports expressions like {{ $json.cardId }}.
Attachment ID	string	Yes	—	The ID of the attachment

Attachment: Get

Parameter	Type	Required	Default	Description
Card ID (cardId)	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name. Supports expressions like {{ $json.cardId }}.
Attachment ID	string	Yes	—	The ID of the attachment
Additional Fields (additionalFields)	collection	No	{}	Optional fields controlling what the response contains.
— Fields	string	No	all	Fields to return. Either “all” or a comma-separated list of fields.

Attachment: Get Many

Parameter	Type	Required	Default	Description
Card ID (cardId)	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name. Supports expressions like {{ $json.cardId }}.
Additional Fields (additionalFields)	collection	No	{}	Optional fields controlling what the response contains.
— Fields	string	No	all	Fields to return. Either “all” or a comma-separated list of fields.

All Operations

Parameter	Type	Required	Default	Description
Max Concurrency	number	No	10	Maximum number of items to process concurrently.

Output Data

The Trello response is merged into the item JSON at the top level, so the record’s own properties sit directly on the item, the incoming item’s other fields pass through alongside them, and binary data on the input item is forwarded unchanged.

How many items you get back depends on whether Trello returns one record or a collection.

Operations	Items produced per input item
Board Member: Get Many, List: Get Many, List: Get Cards, Label: Get Many, Checklist: Get Many, Checklist: Get Completed Checklist Items, Attachment: Get Many	One output item per record in the collection
Every other operation	Exactly one output item

Two consequences are worth planning for:

• An empty collection produces nothing. When one of the fan-out operations matches no records, that input item contributes zero output items — the item disappears from the branch rather than arriving with an empty array. Anything downstream that must run once per input item should not sit behind one of these operations.
• Each record replaces same-named input fields. The merge is shallow and the Trello record wins, so an incoming name or id is overwritten by the board, card or list that came back.

Return All and Limit appear on Board Member: Get Many, List: Get Many and List: Get Cards only. The node makes a single request per input item in every case — it does not page through the API — so Return All means “emit every record the response contained”, and turning it off trims the response to Limit records before they become items (for List: Get Cards, Limit is also sent to the API with the request). The other collection operations have no Return All or Limit at all and always emit everything the response contained.

Reference the result downstream by expression, e.g. {{ $json.id }} for the ID of the record that was created, read or listed.

Usage Examples

• Create a new Trello card in a list
• Get all cards from a Trello list
• Add a label to a Trello card
• Create a checklist on a Trello card
• Invite a member to a Trello board

Example Configuration

Create a private board with the default lists and labels:

{
  "type": "trello",
  "parameters": {
    "resource": "board",
    "operation": "create",
    "name": "My New Board",
    "description": "A board for project management",
    "additionalFields": {
      "prefs_permissionLevel": "private",
      "prefs_cardCovers": true,
      "defaultLabels": true,
      "defaultLists": true
    }
  }
}

Create a card at the bottom of a list with a due date:

{
  "type": "trello",
  "parameters": {
    "resource": "card",
    "operation": "create",
    "listId": "5f1a2b3c4d5e6f7g8h9i0j1k",
    "name": "New Task",
    "description": "Task description here",
    "additionalFields": {
      "due": "2024-01-15T10:00:00Z",
      "dueComplete": false,
      "pos": "bottom"
    }
  }
}

Add an existing Trello user to a board as a normal member:

{
  "type": "trello",
  "parameters": {
    "resource": "boardMember",
    "operation": "add",
    "id": "5f1a2b3c4d5e6f7g8h9i0j1k",
    "idMember": "6f2b3c4d5e6f7g8h9i0j1k2l",
    "type": "normal",
    "additionalFields": {
      "allowBillableGuest": false
    }
  }
}

Add a checklist to a card:

{
  "type": "trello",
  "parameters": {
    "resource": "checklist",
    "operation": "create",
    "cardId": "5f1a2b3c4d5e6f7g8h9i0j1k",
    "name": "Todo Items",
    "additionalFields": {
      "pos": "bottom"
    }
  }
}

Attach an existing label to a card:

{
  "type": "trello",
  "parameters": {
    "resource": "label",
    "operation": "addLabel",
    "cardId": "5f1a2b3c4d5e6f7g8h9i0j1k",
    "id": "6f2b3c4d5e6f7g8h9i0j1k2l"
  }
}

List a board’s lists, capped at 50 records:

{
  "type": "trello",
  "parameters": {
    "resource": "list",
    "operation": "getAll",
    "id": "5f1a2b3c4d5e6f7g8h9i0j1k",
    "returnAll": false,
    "limit": 50,
    "additionalFields": {
      "fields": "all"
    }
  }
}

Rename a card and move its due date:

{
  "type": "trello",
  "parameters": {
    "resource": "card",
    "operation": "update",
    "id": "5f1a2b3c4d5e6f7g8h9i0j1k",
    "updateFields": {
      "name": "Updated Task Name",
      "desc": "Updated description",
      "due": "2024-02-01T15:00:00Z",
      "closed": false
    }
  }
}

Attach a document URL to a card:

{
  "type": "trello",
  "parameters": {
    "resource": "attachment",
    "operation": "create",
    "cardId": "5f1a2b3c4d5e6f7g8h9i0j1k",
    "url": "https://example.com/document.pdf",
    "additionalFields": {
      "name": "Project Document",
      "mimeType": "application/pdf"
    }
  }
}

Set up a board end to end with three chained nodes. Because each response is merged onto the item, the next node reads the ID it needs from {{ $json.id }}:

{
  "type": "trello",
  "parameters": {
    "resource": "board",
    "operation": "create",
    "name": "Project Alpha",
    "description": "Main project board",
    "additionalFields": {
      "prefs_permissionLevel": "private",
      "defaultLists": true
    }
  }
}

{
  "type": "trello",
  "parameters": {
    "resource": "list",
    "operation": "create",
    "idBoard": "{{ $json.id }}",
    "name": "In Progress"
  }
}

{
  "type": "trello",
  "parameters": {
    "resource": "card",
    "operation": "create",
    "listId": "{{ $json.id }}",
    "name": "First Task",
    "description": "Initial task setup"
  }
}

Build a card, its checklist and the first checklist item in the same chain:

{
  "type": "trello",
  "parameters": {
    "resource": "card",
    "operation": "create",
    "listId": "5f1a2b3c4d5e6f7g8h9i0j1k",
    "name": "Complex Task",
    "description": "Task with full configuration",
    "additionalFields": {
      "due": "2024-01-20T12:00:00Z",
      "pos": "top"
    }
  }
}

{
  "type": "trello",
  "parameters": {
    "resource": "checklist",
    "operation": "create",
    "cardId": "{{ $json.id }}",
    "name": "Subtasks"
  }
}

{
  "type": "trello",
  "parameters": {
    "resource": "checklist",
    "operation": "createCheckItem",
    "checklistId": "{{ $json.id }}",
    "name": "Complete research"
  }
}

Error Handling

Mode	Behavior
stop	Halts workflow on first error
continue	Skips failed items, passes successful ones through
errorPort	Routes failed items to Error output port

Tips

Manage Trello boards, cards, lists, labels, checklists, attachments, members, and comments via the Trello API.

Key Parameter Relationships

1. Resource → Operation: Each resource has specific available operations
2. Operation → Fields: Different operations expose different parameter sets
3. returnAll → limit: When returnAll is false, limit parameter becomes available
4. Collection Fields: Always use flat object structure without _default or arrays
5. ID Dependencies: Many operations require IDs from previous operations (cards need listId, comments need cardId, etc.)