Overview
Trello is a kanban-style project management tool – boards, lists, cards. The Automize Trello connector covers card lifecycle, board/list management, comments, checklists, members, labels, and attachments.
- Regions: Trello is a single global service – api.trello.com.
- Plans: Free, Standard, Premium, Enterprise – all expose the API. Some features (custom fields, board permissions) need Standard or above.
Setting up the connection
Auth type: API Key.
- Sign in to trello.com/app-key → copy your API Key.
- Click 'Generate a Token' (or use OAuth for multi-user apps). Copy the token.
- In Automize, open Settings → Connectors → Trello → Add connection. Paste key + token.
Find your credentials at https://trello.com/app-key.
Rate limits
Trello enforces 300 requests / 10 sec per API key, plus 100/10 sec per token. Connector retries 429 with Retry-After.
Data model
Trello's primitives:
Workspace ─┬─ Boards ─┬─ Lists (columns) ─── Cards ─┬─ Checklists ─── Check Items
│ │ ├─ Comments
│ │ ├─ Attachments
│ │ ├─ Labels
│ │ ├─ Members (assigned)
│ │ └─ Custom Fields
│ └─ Labels (board-level)
└─ Members
Card IDs (short string, e.g. 5e8a...) are global. Same for boards / lists.Available operations
18 operations available. Click any row to jump to its detail.
| Operation | Category | What it does |
|---|---|---|
| Add Attachment | General | Add an attachment to a card |
| Add Comment | General | Add a comment to a card |
| Add label | General | Add a label to a Trello card. |
| Archive card | General | Archive a Trello card. |
| Create Card | General | Create a new card |
| Create checklist | General | Create a checklist on a Trello card. |
| Create list | General | Create a list on a Trello board. |
| Delete Card | General | Delete a card |
| Get Board | General | Get board details |
| Get Card | General | Get card details |
| List Boards | General | List boards for the authenticated user |
| List Cards | General | List cards on a board or list |
| List checklists | General | List checklists on a Trello card. |
| List labels | General | List labels on a Trello board. |
| List Lists | General | List lists on a board |
| List Members | General | List board members |
| Search | General | Search Trello |
| Update Card | General | Update a card |
Operations
Add Attachment
Add an attachment to a card
| Parameter | Required | Type | Description |
|---|---|---|---|
Card Id card_id | Yes | text | |
Url url | Yes | text | |
Name name | Yes | text |
Tips
- card_id + url (link to file) OR file (binary upload).
Add Comment
Add a comment to a card
| Parameter | Required | Type | Description |
|---|---|---|---|
Card Id card_id | Yes | text |
Tips
- card_id + text (Markdown).
Add label
Add a label to a Trello card.
| Parameter | Required | Type | Description |
|---|---|---|---|
Card Id card_id | Yes | text | |
Value value | No | text |
Tips
- card_id + label_id (from board's label list).
Archive card
Archive a Trello card.
| Parameter | Required | Type | Description |
|---|---|---|---|
Card Id card_id | Yes | text | |
Closed closed | No | switch |
Create Card
Create a new card
No input parameters.
Tips
- idList + name + desc (Markdown). Members + labels are arrays of IDs.
- due (datetime) + dueComplete (bool) for due dates.
Create checklist
Create a checklist on a Trello card.
| Parameter | Required | Type | Description |
|---|---|---|---|
Idcard idCard | No | text | |
Name name | Yes | text |
Create list
Create a list on a Trello board.
| Parameter | Required | Type | Description |
|---|---|---|---|
Name name | Yes | text | |
Idboard idBoard | No | text |
Tips
- board_id + name + (optional pos: 'top' or 'bottom' or a numeric position).
Delete Card
Delete a card
| Parameter | Required | Type | Description |
|---|---|---|---|
Card Id card_id | Yes | text |
Tips
- Hard-delete. Use Update with closed=true to archive instead (recoverable).
Get Board
Get board details
| Parameter | Required | Type | Description |
|---|---|---|---|
Board Id board_id | Yes | text |
Tips
- board_id. Returns board + members + lists + cards via expansions.
Get Card
Get card details
| Parameter | Required | Type | Description |
|---|---|---|---|
Card Id card_id | Yes | text |
Tips
- card_id. Returns card + members + labels + checklists if requested.
List Boards
List boards for the authenticated user
No input parameters.
Tips
- member_id: 'me' for your own boards, or another member's ID.
- filter: open, closed, all.
List Cards
List cards on a board or list
| Parameter | Required | Type | Description |
|---|---|---|---|
List Id list_id | Yes | text |
Tips
- list_id or board_id (with filter for scope).
List checklists
List checklists on a Trello card.
| Parameter | Required | Type | Description |
|---|---|---|---|
Card Id card_id | Yes | text |
List labels
List labels on a Trello board.
| Parameter | Required | Type | Description |
|---|---|---|---|
Board Id board_id | Yes | text |
List Lists
List lists on a board
| Parameter | Required | Type | Description |
|---|---|---|---|
Board Id board_id | Yes | text |
Tips
- board_id. Returns lists (columns) in order.
List Members
List board members
| Parameter | Required | Type | Description |
|---|---|---|---|
Board Id board_id | Yes | text |
Search
Search Trello
No input parameters.
Update Card
Update a card
| Parameter | Required | Type | Description |
|---|---|---|---|
Card Id card_id | Yes | text |
Tips
- PUT-style. closed=true archives the card.
FAQ
- Why does my Create Card put it at the bottom?
- Default pos is 'bottom'. Pass pos='top' or a numeric value to control placement.
- Archive vs delete?
- Archive (closed=true) is recoverable from Board → Show Menu → Archived items. Delete is permanent. Use archive unless you really mean to destroy.
- Custom fields – how?
- Custom fields are a Power-Up. Use the Custom Fields Plugin API endpoints (not currently exposed) to read/write – or pre-set via the Trello UI.