# Trello (/integrations/trello)





{/* MANUAL-CONTENT-START:intro */}

Use [Trello](https://trello.com) to manage boards, lists, cards, checklists, labels, and members, or retrieve activity and add comments. Complete the OAuth Allowed Origins setup below before connecting your account.

{/* MANUAL-CONTENT-END */}

Connection guides: [API tokens](/integrations/trello-service-account).

## OAuth scopes [#oauth-scopes]

Sim requests these scopes when someone connects a Trello account. For a self-hosted deployment, register your own app with the provider using the settings below. See [Integrations and OAuth](/platform/self-hosting/integrations-oauth) for setup.

| Setting | Value |
| - | - |
| Environment variables | `TRELLO_API_KEY` |

| Scope | Description |
| - | - |
| `read` | Read boards, lists, cards, and workspaces |
| `write` | Create and update boards, lists, and cards |

## Use the block [#usage-instructions]

{/* MANUAL-CONTENT-START:usage */}

## Trello OAuth setup [#trello-oauth-setup]

Before connecting Trello in Sim, add your Sim app origin to the **Allowed Origins** list for your Trello API key in the Trello Power-Up admin settings.

Trello's authorization flow redirects back to Sim using a `return_url`. If your Sim origin is not whitelisted in Trello, Trello will block the redirect and the connection flow will fail before Sim can save the token.

{/* MANUAL-CONTENT-END */}

Integrate with Trello to list, search, create, update, and delete cards and lists, manage checklists and checklist items, assign labels and members, review activity, and add comments.

## Actions [#actions]

### Trello Get Lists [#trello-get-lists]

List all lists on a Trello board

<ReferenceDetails>
  #### Input [#input]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `boardId` | string | Yes | Trello board ID (24-character hex string) |
  | `filter` | string | No | Which lists to return: open, closed, or all (defaults to open) |

  #### Output [#output]

  | Parameter | Type | Description |
  | - | - | - |
  | `lists` | array | Lists on the selected board |
  | ↳ `id` | string | List ID |
  | ↳ `name` | string | List name |
  | ↳ `closed` | boolean | Whether the list is archived |
  | ↳ `pos` | number | List position on the board |
  | ↳ `idBoard` | string | Board ID containing the list |
  | `count` | number | Number of lists returned |
</ReferenceDetails>

### Trello List Cards [#trello-list-cards]

List cards from a Trello board or list

<ReferenceDetails>
  #### Input [#input-1]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `boardId` | string | No | Trello board ID to list open cards from. Provide either boardId or listId |
  | `listId` | string | No | Trello list ID to list cards from. Provide either boardId or listId |
  | `filter` | string | No | Which cards to return: open, closed, or all (defaults to open) |

  #### Output [#output-1]

  | Parameter | Type | Description |
  | - | - | - |
  | `cards` | array | Cards returned from the selected Trello board or list |
  | ↳ `id` | string | Card ID |
  | ↳ `name` | string | Card name |
  | ↳ `desc` | string | Card description |
  | ↳ `url` | string | Full card URL |
  | ↳ `idBoard` | string | Board ID containing the card |
  | ↳ `idList` | string | List ID containing the card |
  | ↳ `closed` | boolean | Whether the card is archived |
  | ↳ `labelIds` | array | Label IDs applied to the card |
  | ↳ `labels` | array | Labels applied to the card |
  | ↳ `id` | string | Label ID |
  | ↳ `name` | string | Label name |
  | ↳ `color` | string | Label color |
  | ↳ `due` | string | Card due date in ISO 8601 format |
  | ↳ `dueComplete` | boolean | Whether the due date is complete |
  | `count` | number | Number of cards returned |
</ReferenceDetails>

### Trello Search [#trello-search]

Search Trello cards and boards by keyword

<ReferenceDetails>
  #### Input [#input-2]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `query` | string | Yes | Search text, supports Trello search operators (e.g. board:, list:, due:) |
  | `idBoards` | array | No | Restrict the search to these board IDs |
  | `modelTypes` | string | No | Comma-separated result types to search: cards, boards, or all (default all) |
  | `cardsLimit` | number | No | Maximum number of cards to return (1-1000, default 10) |

  #### Output [#output-2]

  | Parameter | Type | Description |
  | - | - | - |
  | `cards` | array | Cards matching the search query |
  | ↳ `id` | string | Card ID |
  | ↳ `name` | string | Card name |
  | ↳ `desc` | string | Card description |
  | ↳ `url` | string | Full card URL |
  | ↳ `idBoard` | string | Board ID containing the card |
  | ↳ `idList` | string | List ID containing the card |
  | ↳ `closed` | boolean | Whether the card is archived |
  | `boards` | array | Boards matching the search query |
  | ↳ `id` | string | Board ID |
  | ↳ `name` | string | Board name |
  | ↳ `desc` | string | Board description |
  | ↳ `url` | string | Full board URL |
  | ↳ `closed` | boolean | Whether the board is archived |
  | ↳ `idOrganization` | string | Workspace/organization ID that owns the board |
  | `count` | number | Total number of cards and boards returned |
</ReferenceDetails>

### Trello Create Card [#trello-create-card]

Create a new card in a Trello list

<ReferenceDetails>
  #### Input [#input-3]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `listId` | string | Yes | Trello list ID (24-character hex string) |
  | `name` | string | Yes | Name/title of the card |
  | `desc` | string | No | Description of the card |
  | `pos` | string | No | Position of the card (top, bottom, or positive float) |
  | `due` | string | No | Due date (ISO 8601 format) |
  | `dueComplete` | boolean | No | Whether the due date should be marked complete |
  | `labelIds` | array | No | Label IDs to attach to the card |
  | `memberIds` | array | No | Member IDs to assign to the card |

  #### Output [#output-3]

  | Parameter | Type | Description |
  | - | - | - |
  | `card` | json | Created card (id, name, desc, url, idBoard, idList, closed, labelIds, labels, due, dueComplete) |
  | ↳ `id` | string | Card ID |
  | ↳ `name` | string | Card name |
  | ↳ `desc` | string | Card description |
  | ↳ `url` | string | Full card URL |
  | ↳ `idBoard` | string | Board ID containing the card |
  | ↳ `idList` | string | List ID containing the card |
  | ↳ `closed` | boolean | Whether the card is archived |
  | ↳ `labelIds` | array | Label IDs applied to the card |
  | ↳ `labels` | array | Labels applied to the card |
  | ↳ `id` | string | Label ID |
  | ↳ `name` | string | Label name |
  | ↳ `color` | string | Label color |
  | ↳ `due` | string | Card due date in ISO 8601 format |
  | ↳ `dueComplete` | boolean | Whether the due date is complete |
</ReferenceDetails>

### Trello Update Card [#trello-update-card]

Update an existing card on Trello

<ReferenceDetails>
  #### Input [#input-4]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `cardId` | string | Yes | Trello card ID (24-character hex string) |
  | `name` | string | No | New name/title of the card |
  | `desc` | string | No | New description of the card |
  | `closed` | boolean | No | Archive/close the card (true) or reopen it (false) |
  | `idList` | string | No | Trello list ID to move card to (24-character hex string) |
  | `due` | string | No | Due date (ISO 8601 format) |
  | `dueComplete` | boolean | No | Mark the due date as complete |

  #### Output [#output-4]

  | Parameter | Type | Description |
  | - | - | - |
  | `card` | json | Updated card (id, name, desc, url, idBoard, idList, closed, labelIds, labels, due, dueComplete) |
  | ↳ `id` | string | Card ID |
  | ↳ `name` | string | Card name |
  | ↳ `desc` | string | Card description |
  | ↳ `url` | string | Full card URL |
  | ↳ `idBoard` | string | Board ID containing the card |
  | ↳ `idList` | string | List ID containing the card |
  | ↳ `closed` | boolean | Whether the card is archived |
  | ↳ `labelIds` | array | Label IDs applied to the card |
  | ↳ `labels` | array | Labels applied to the card |
  | ↳ `id` | string | Label ID |
  | ↳ `name` | string | Label name |
  | ↳ `color` | string | Label color |
  | ↳ `due` | string | Card due date in ISO 8601 format |
  | ↳ `dueComplete` | boolean | Whether the due date is complete |
</ReferenceDetails>

### Trello Delete Card [#trello-delete-card]

Permanently delete a Trello card

<ReferenceDetails>
  #### Input [#input-5]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `cardId` | string | Yes | Trello card ID to permanently delete (24-character hex string) |

  #### Output [#output-5]

  | Parameter | Type | Description |
  | - | - | - |
  | `success` | boolean | Whether the card was deleted |
</ReferenceDetails>

### Trello Get Actions [#trello-get-actions]

Get activity/actions from a board or card

<ReferenceDetails>
  #### Input [#input-6]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `boardId` | string | No | Trello board ID (24-character hex string). Either boardId or cardId required |
  | `cardId` | string | No | Trello card ID (24-character hex string). Either boardId or cardId required |
  | `filter` | string | No | Filter actions by type (e.g., "commentCard,updateCard,createCard" or "all") |
  | `limit` | number | No | Maximum number of board actions to return |
  | `page` | number | No | Page number for action results |
  | `since` | string | No | Only return actions after this date (ISO 8601 timestamp) or action ID, for paging through long histories |
  | `before` | string | No | Only return actions before this date (ISO 8601 timestamp) or action ID, for paging through long histories |

  #### Output [#output-6]

  | Parameter | Type | Description |
  | - | - | - |
  | `actions` | array | Action items (id, type, date, idMemberCreator, text, memberCreator, card, board, list) |
  | ↳ `id` | string | Action ID |
  | ↳ `type` | string | Action type |
  | ↳ `date` | string | Action timestamp |
  | ↳ `idMemberCreator` | string | ID of the member who created the action |
  | ↳ `text` | string | Comment text when present |
  | ↳ `memberCreator` | object | Member who created the action |
  | ↳ `id` | string | Member ID |
  | ↳ `fullName` | string | Member full name |
  | ↳ `username` | string | Member username |
  | ↳ `card` | object | Card referenced by the action |
  | ↳ `id` | string | Card ID |
  | ↳ `name` | string | Card name |
  | ↳ `shortLink` | string | Short card link |
  | ↳ `idShort` | number | Board-local card number |
  | ↳ `due` | string | Card due date |
  | ↳ `board` | object | Board referenced by the action |
  | ↳ `id` | string | Board ID |
  | ↳ `name` | string | Board name |
  | ↳ `shortLink` | string | Short board link |
  | ↳ `list` | object | List referenced by the action |
  | ↳ `id` | string | List ID |
  | ↳ `name` | string | List name |
  | `count` | number | Number of actions returned |
</ReferenceDetails>

### Trello Add Comment [#trello-add-comment]

Add a comment to a Trello card

<ReferenceDetails>
  #### Input [#input-7]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `cardId` | string | Yes | Trello card ID (24-character hex string) |
  | `text` | string | Yes | Comment text |

  #### Output [#output-7]

  | Parameter | Type | Description |
  | - | - | - |
  | `comment` | json | Created comment action (id, type, date, idMemberCreator, text, memberCreator, card, board, list) |
  | ↳ `id` | string | Action ID |
  | ↳ `type` | string | Action type |
  | ↳ `date` | string | Action timestamp |
  | ↳ `idMemberCreator` | string | ID of the member who created the comment |
  | ↳ `text` | string | Comment text |
  | ↳ `memberCreator` | object | Member who created the comment |
  | ↳ `id` | string | Member ID |
  | ↳ `fullName` | string | Member full name |
  | ↳ `username` | string | Member username |
  | ↳ `card` | object | Card referenced by the comment |
  | ↳ `id` | string | Card ID |
  | ↳ `name` | string | Card name |
  | ↳ `shortLink` | string | Short card link |
  | ↳ `idShort` | number | Board-local card number |
  | ↳ `due` | string | Card due date |
  | ↳ `board` | object | Board referenced by the comment |
  | ↳ `id` | string | Board ID |
  | ↳ `name` | string | Board name |
  | ↳ `shortLink` | string | Short board link |
  | ↳ `list` | object | List referenced by the comment |
  | ↳ `id` | string | List ID |
  | ↳ `name` | string | List name |
</ReferenceDetails>

### Trello Create Board [#trello-create-board]

Create a new Trello board

<ReferenceDetails>
  #### Input [#input-8]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `name` | string | Yes | Name of the board |
  | `desc` | string | No | Description of the board |
  | `idOrganization` | string | No | ID or name of the workspace/organization the board belongs to |
  | `defaultLists` | boolean | No | Whether to create the default lists (To Do, Doing, Done) on the new board |

  #### Output [#output-8]

  | Parameter | Type | Description |
  | - | - | - |
  | `board` | json | Created board (id, name, desc, url, closed, idOrganization) |
  | ↳ `id` | string | Board ID |
  | ↳ `name` | string | Board name |
  | ↳ `desc` | string | Board description |
  | ↳ `url` | string | Full board URL |
  | ↳ `closed` | boolean | Whether the board is closed |
  | ↳ `idOrganization` | string | ID of the workspace/organization the board belongs to |
</ReferenceDetails>

### Trello Get Board [#trello-get-board]

Retrieve a single Trello board by ID

<ReferenceDetails>
  #### Input [#input-9]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `boardId` | string | Yes | Trello board ID (24-character hex string) |

  #### Output [#output-9]

  | Parameter | Type | Description |
  | - | - | - |
  | `board` | json | Board (id, name, desc, url, closed, idOrganization) |
  | ↳ `id` | string | Board ID |
  | ↳ `name` | string | Board name |
  | ↳ `desc` | string | Board description |
  | ↳ `url` | string | Full board URL |
  | ↳ `closed` | boolean | Whether the board is closed |
  | ↳ `idOrganization` | string | ID of the workspace/organization the board belongs to |
</ReferenceDetails>

### Trello Create List [#trello-create-list]

Create a new list on a Trello board

<ReferenceDetails>
  #### Input [#input-10]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `boardId` | string | Yes | Trello board ID the list belongs to (24-character hex string) |
  | `name` | string | Yes | Name of the list |
  | `pos` | string | No | Position of the list (top, bottom, or positive float) |

  #### Output [#output-10]

  | Parameter | Type | Description |
  | - | - | - |
  | `list` | json | Created list (id, name, closed, pos, idBoard) |
  | ↳ `id` | string | List ID |
  | ↳ `name` | string | List name |
  | ↳ `closed` | boolean | Whether the list is archived |
  | ↳ `pos` | number | List position on the board |
  | ↳ `idBoard` | string | Board ID containing the list |
</ReferenceDetails>

### Trello Update List [#trello-update-list]

Rename, move, archive, or reopen a Trello list

<ReferenceDetails>
  #### Input [#input-11]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `listId` | string | Yes | Trello list ID (24-character hex string) |
  | `name` | string | No | New name of the list |
  | `closed` | boolean | No | Archive the list (true) or reopen it (false) |
  | `idBoard` | string | No | Board ID to move the list to (24-character hex string) |
  | `pos` | string | No | New position of the list (top, bottom, or positive float) |

  #### Output [#output-11]

  | Parameter | Type | Description |
  | - | - | - |
  | `list` | json | Updated list (id, name, closed, pos, idBoard) |
  | ↳ `id` | string | List ID |
  | ↳ `name` | string | List name |
  | ↳ `closed` | boolean | Whether the list is archived |
  | ↳ `pos` | number | List position on the board |
  | ↳ `idBoard` | string | Board ID containing the list |
</ReferenceDetails>

### Trello Get Card [#trello-get-card]

Retrieve a single Trello card by ID

<ReferenceDetails>
  #### Input [#input-12]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `cardId` | string | Yes | Trello card ID (24-character hex string) |

  #### Output [#output-12]

  | Parameter | Type | Description |
  | - | - | - |
  | `card` | json | Card (id, name, desc, url, idBoard, idList, closed, labelIds, labels, due, dueComplete) |
  | ↳ `id` | string | Card ID |
  | ↳ `name` | string | Card name |
  | ↳ `desc` | string | Card description |
  | ↳ `url` | string | Full card URL |
  | ↳ `idBoard` | string | Board ID containing the card |
  | ↳ `idList` | string | List ID containing the card |
  | ↳ `closed` | boolean | Whether the card is archived |
  | ↳ `labelIds` | array | Label IDs applied to the card |
  | ↳ `labels` | array | Labels applied to the card |
  | ↳ `id` | string | Label ID |
  | ↳ `name` | string | Label name |
  | ↳ `color` | string | Label color |
  | ↳ `due` | string | Card due date in ISO 8601 format |
  | ↳ `dueComplete` | boolean | Whether the due date is complete |
</ReferenceDetails>

### Trello Add Checklist [#trello-add-checklist]

Add a checklist to a Trello card

<ReferenceDetails>
  #### Input [#input-13]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `cardId` | string | Yes | Trello card ID to add the checklist to (24-character hex string) |
  | `name` | string | Yes | Name of the checklist |
  | `pos` | string | No | Position of the checklist (top, bottom, or positive float) |

  #### Output [#output-13]

  | Parameter | Type | Description |
  | - | - | - |
  | `checklist` | json | Created checklist (id, name, idCard, idBoard, pos) |
  | ↳ `id` | string | Checklist ID |
  | ↳ `name` | string | Checklist name |
  | ↳ `idCard` | string | Card ID containing the checklist |
  | ↳ `idBoard` | string | Board ID containing the checklist |
  | ↳ `pos` | number | Checklist position on the card |
</ReferenceDetails>

### Trello Add Checklist Item [#trello-add-checklist-item]

Add an item to a Trello checklist

<ReferenceDetails>
  #### Input [#input-14]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `checklistId` | string | Yes | Trello checklist ID to add the item to (24-character hex string) |
  | `name` | string | Yes | Name of the checklist item |
  | `pos` | string | No | Position of the item (top, bottom, or positive float) |
  | `checked` | boolean | No | Whether the item should start checked off |

  #### Output [#output-14]

  | Parameter | Type | Description |
  | - | - | - |
  | `item` | json | Created checklist item (id, name, state, pos, idChecklist) |
  | ↳ `id` | string | Checklist item ID |
  | ↳ `name` | string | Checklist item name |
  | ↳ `state` | string | Item state (complete or incomplete) |
  | ↳ `pos` | number | Item position on the checklist |
  | ↳ `idChecklist` | string | Checklist ID containing the item |
</ReferenceDetails>

### Trello Update Checklist Item [#trello-update-checklist-item]

Check off, uncheck, or rename a Trello checklist item

<ReferenceDetails>
  #### Input [#input-15]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `cardId` | string | Yes | Trello card ID that owns the checklist item (24-character hex string) |
  | `checkItemId` | string | Yes | Checklist item ID to update (24-character hex string) |
  | `state` | string | No | Set the item state to complete or incomplete |
  | `name` | string | No | New name for the checklist item |

  #### Output [#output-15]

  | Parameter | Type | Description |
  | - | - | - |
  | `item` | json | Updated checklist item (id, name, state, pos, idChecklist) |
  | ↳ `id` | string | Checklist item ID |
  | ↳ `name` | string | Checklist item name |
  | ↳ `state` | string | Item state (complete or incomplete) |
  | ↳ `pos` | number | Item position on the checklist |
  | ↳ `idChecklist` | string | Checklist ID containing the item |
</ReferenceDetails>

### Trello Add Label [#trello-add-label]

Attach an existing label to a Trello card

<ReferenceDetails>
  #### Input [#input-16]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `cardId` | string | Yes | Trello card ID to attach the label to (24-character hex string) |
  | `labelId` | string | Yes | ID of the label to attach (24-character hex string) |

  #### Output [#output-16]

  | Parameter | Type | Description |
  | - | - | - |
  | `labelIds` | array | Label IDs now applied to the card |
</ReferenceDetails>

### Trello Remove Label [#trello-remove-label]

Detach a label from a Trello card

<ReferenceDetails>
  #### Input [#input-17]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `cardId` | string | Yes | Trello card ID to detach the label from (24-character hex string) |
  | `labelId` | string | Yes | ID of the label to detach (24-character hex string) |

  #### Output [#output-17]

  | Parameter | Type | Description |
  | - | - | - |
  | `success` | boolean | Whether the label was removed from the card |
</ReferenceDetails>

### Trello Add Member [#trello-add-member]

Assign a member to a Trello card

<ReferenceDetails>
  #### Input [#input-18]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `cardId` | string | Yes | Trello card ID to assign the member to (24-character hex string) |
  | `memberId` | string | Yes | ID of the member to assign (24-character hex string) |

  #### Output [#output-18]

  | Parameter | Type | Description |
  | - | - | - |
  | `memberIds` | array | Member IDs now assigned to the card |
</ReferenceDetails>

### Trello Remove Member [#trello-remove-member]

Unassign a member from a Trello card

<ReferenceDetails>
  #### Input [#input-19]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `cardId` | string | Yes | Trello card ID to unassign the member from (24-character hex string) |
  | `memberId` | string | Yes | ID of the member to unassign (24-character hex string) |

  #### Output [#output-19]

  | Parameter | Type | Description |
  | - | - | - |
  | `success` | boolean | Whether the member was removed from the card |
</ReferenceDetails>

### Trello List Members [#trello-list-members]

List members of a Trello board

<ReferenceDetails>
  #### Input [#input-20]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `boardId` | string | Yes | Trello board ID (24-character hex string) |

  #### Output [#output-20]

  | Parameter | Type | Description |
  | - | - | - |
  | `members` | array | Members on the selected board |
  | ↳ `id` | string | Member ID |
  | ↳ `fullName` | string | Member full name |
  | ↳ `username` | string | Member username |
  | `count` | number | Number of members returned |
</ReferenceDetails>