Trello integration

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.

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

Attachment: Create

Parameter	Type	Required	Default	Description
Card ID	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name
Source URL	string	Yes	—	The URL of the attachment to add
Additional Fields	collection	No	{}
				Options: pirate, disabled, admins, org, all, normal, complete
— 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	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name
Attachment ID	string	Yes	—	The ID of the attachment.

Attachment: Get

Parameter	Type	Required	Default	Description
Card ID	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name
Attachment ID	string	Yes	—	The ID of the attachment.
Additional Fields	collection	No	{}
				Options: pirate, disabled, admins, org, all, normal, complete
— 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	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name
Additional Fields	collection	No	{}
				Options: pirate, disabled, admins, org, all, normal, complete
— Fields	string	No	all	Fields to return. Either “all” or a comma-separated list of fields.

Board: Create

Parameter	Type	Required	Default	Description
Name	string	Yes	—	The name of the record being created.
Description	string	No	—	The description of the board or card.
Additional Fields	collection	No	{}
				Options: pirate, disabled, admins, org, all, normal, complete
— 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, 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, 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, public

Board: Delete

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

Board: Get

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
Additional Fields	collection	No	{}
				Options: pirate, disabled, admins, org, all, normal, complete
— 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 (boardId)	string	Yes	—	The ID of the board. Find at the end of your board URL: https://trello.com/b/{boardId}/board-name
Update Fields	collection	No	{}
				Options: black
— 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 (boardId)	string	Yes	—	The ID of the board. Find at the end of your board URL: https://trello.com/b/{boardId}/board-name
Member ID	string	Yes	—	The ID of the member to add to or remove from 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 (Trello premium feature))
Additional Fields	collection	No	{}
				Options: pirate, disabled, admins, org, all, normal, complete
— 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 (boardId)	string	Yes	—	The ID of the board. Find at the end of your board URL: https://trello.com/b/{boardId}/board-name
Return All	boolean	No	false	Whether to return all results or only up to a given 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 (boardId)	string	Yes	—	The ID of the board. Find at the end of your board URL: https://trello.com/b/{boardId}/board-name
Email	string	Yes	—	The email of the member to invite
Additional Fields	collection	No	{}
				Options: pirate, disabled, admins, org, all, normal, complete
— 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 (boardId)	string	Yes	—	The ID of the board. Find at the end of your board URL: https://trello.com/b/{boardId}/board-name
Member ID	string	Yes	—	The ID of the member to add to or remove from the board.

Card: Create

Parameter	Type	Required	Default	Description
List ID	string	Yes	—	The ID of the list. For card:create, the list the new card is added to.
Name	string	Yes	—	The name of the record being created.
Description	string	No	—	The description of the board or card.
Additional Fields	collection	No	{}
				Options: pirate, disabled, admins, org, all, normal, complete
— 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	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name

Card: Get

Parameter	Type	Required	Default	Description
Card ID	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name
Additional Fields	collection	No	{}
				Options: pirate, disabled, admins, org, all, normal, complete
— 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	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name
Update Fields	collection	No	{}
				Options: black
— 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	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name
Text	string	Yes	—	The text of the comment.

Card Comment: Delete

Parameter	Type	Required	Default	Description
Card ID	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name
Comment ID	string	Yes	—	The ID of the comment to update or delete.

Card Comment: Update

Parameter	Type	Required	Default	Description
Card ID	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name
Comment ID	string	Yes	—	The ID of the comment to update or delete.
Text	string	Yes	—	The text of the comment.

Checklist: Create

Parameter	Type	Required	Default	Description
Card ID	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name
Name	string	Yes	—	The name of the record being created.
Additional Fields	collection	No	{}
				Options: pirate, disabled, admins, org, all, normal, complete
— 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	string	Yes	—	The ID of the checklist. For checklist:createCheckItem, the checklist the new item is added to.
Name	string	Yes	—	The name of the record being created.
Additional Fields	collection	No	{}
				Options: pirate, disabled, admins, org, all, normal, complete
— 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	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name
Checklist ID	string	Yes	—	The ID of the checklist. For checklist:createCheckItem, the checklist the new item is added to.

Checklist: Delete Checklist Item

Parameter	Type	Required	Default	Description
Card ID	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name
CheckItem ID	string	Yes	—	The ID of the checklist item to get, update or delete.

Checklist: Get

Parameter	Type	Required	Default	Description
Checklist ID	string	Yes	—	The ID of the checklist. For checklist:createCheckItem, the checklist the new item is added to.
Additional Fields	collection	No	{}
				Options: pirate, disabled, admins, org, all, normal, complete
— 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	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name
CheckItem ID	string	Yes	—	The ID of the checklist item to get, update or delete.
Additional Fields	collection	No	{}
				Options: pirate, disabled, admins, org, all, normal, complete
— 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	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name
Additional Fields	collection	No	{}
				Options: pirate, disabled, admins, org, all, normal, complete
— 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	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name
Additional Fields	collection	No	{}
				Options: pirate, disabled, admins, org, all, normal, complete
— 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	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name
CheckItem ID	string	Yes	—	The ID of the checklist item to get, update or delete.
Additional Fields	collection	No	{}
				Options: pirate, disabled, admins, org, all, normal, complete
— 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	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name
Label ID	string	Yes	—	The ID of the label.

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
Name	string	Yes	—	The name of the record being created.
Color	options	Yes	null	The color for the label
				Options: black, blue, green, lime, null, orange, pink, purple, red, sky, yellow

Label: Delete

Parameter	Type	Required	Default	Description
Label ID	string	Yes	—	The ID of the label.

Label: Get

Parameter	Type	Required	Default	Description
Label ID	string	Yes	—	The ID of the label.
Additional Fields	collection	No	{}
				Options: pirate, disabled, admins, org, all, normal, complete
— 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
Additional Fields	collection	No	{}
				Options: pirate, disabled, admins, org, all, normal, complete
— 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	string	Yes	—	The ID of the card. Find at the end of your card URL: https://trello.com/c/{cardId}/card-name
Label ID	string	Yes	—	The ID of the label.

Label: Update

Parameter	Type	Required	Default	Description
Label ID	string	Yes	—	The ID of the label.
Update Fields	collection	No	{}
				Options: black
— Name	string	No	—	Name of the label
— Color	options	No	null	The color for the label
				Options: black, blue, green, lime, null, orange, pink, purple, red, sky, yellow

List: Archive

Parameter	Type	Required	Default	Description
List ID	string	Yes	—	The ID of the list. For card:create, the list the new card is added to.
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
Name	string	Yes	—	The name of the record being created.
Additional Fields	collection	No	{}
				Options: pirate, disabled, admins, org, all, normal, complete
— 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	string	Yes	—	The ID of the list. For card:create, the list the new card is added to.
Additional Fields	collection	No	{}
				Options: pirate, disabled, admins, org, all, normal, complete
— 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	string	Yes	—	The ID of the list. For card:create, the list the new card is added to.
Return All	boolean	No	false	Whether to return all results or only up to a given limit
Limit	number	No	20	Max number of results to return (shown when Return All is false)
Additional Fields	collection	No	{}
				Options: pirate, disabled, admins, org, all, normal, complete
— 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 (boardId)	string	Yes	—	The ID of the board. Find at the end of your board URL: https://trello.com/b/{boardId}/board-name
Return All	boolean	No	false	Whether to return all results or only up to a given limit
Limit	number	No	20	Max number of results to return (shown when Return All is false)
Additional Fields	collection	No	{}
				Options: pirate, disabled, admins, org, all, normal, complete
— 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	string	Yes	—	The ID of the list. For card:create, the list the new card is added to.
Update Fields	collection	No	{}
				Options: black
— 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

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.

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",
    "boardId": "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",
    "labelId": "6f2b3c4d5e6f7g8h9i0j1k2l"
  }
}

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

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

Rename a card and move its due date:

{
  "type": "trello",
  "parameters": {
    "resource": "card",
    "operation": "update",
    "cardId": "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

This tool manages Trello boards, cards, lists, labels, checklists, attachments, members, and comments. It is ideal for organizing projects into kanban boards, creating and updating cards, or managing team access. It produces updated Trello resources, such as new cards, updated labels, or lists of board members.

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