nodes / builtin / integration
Trello
Create, update, and move Trello cards from the current page, and attach the page URL.
Turn the page you are on into a Trello card with the link attached, and update or move cards across your boards.
What it does
Section titled “What it does”The Trello node works on three kinds of things (Resource):
- Card: create a card in a list, change its title or description, move it to another list, or attach a link to it.
- Board: list your boards, to find a Board ID.
- List: list the lists (columns) of a board, to find a List ID.
When you fill Source URL on Card → Create, the node does two things: it adds a Source: line with the link to the end of the description, and it attaches the link to the card, so it shows in the card’s attachments with a preview.
When to use it
Section titled “When to use it”- Capture a page as a card in a “To read” or “Ideas” list.
- Add a card to a team board when a form is filled or a page changes.
- Move a card to “Done” when a workflow finishes the task.
- Attach a generated report or a related page to an existing card.
For personal to-dos, use Todoist. For software issues, use Linear or GitHub.
Inputs and settings
Section titled “Inputs and settings”| Setting | Type | What it does |
|---|---|---|
| Credential (required) | Credential | A Trello API key + token, stored as a Basic Auth credential: put the API key in Username and the token in Password. Get both from https://trello.com/app-key (the token is generated from that page). Keep them secret. |
6 choices · pick resource and operation to see its settings
Settings for Card · Create
| Setting | Type | What it does |
|---|---|---|
| Card title (required) | Text | The card name. |
| List ID (required) | Text | The list (column) to add the card to (use List → List to find its ID). |
| Description | Text | Card description (Markdown supported). |
| Source URL | Text | The page URL — attached to the card and appended to the description. |
| Position | Choice | Where in the list to place the card. Options: Top, Bottom. |
Settings for Card · Update
| Setting | Type | What it does |
|---|---|---|
| Card ID (required) | Text | The Trello card ID. |
| Card title | Text | The card name. |
| Description | Text | Card description (Markdown supported). |
Settings for Card · Move
| Setting | Type | What it does |
|---|---|---|
| Card ID (required) | Text | The Trello card ID. |
| Target list ID (required) | Text | The list (column) to move the card to. |
Settings for Card · Attach URL
| Setting | Type | What it does |
|---|---|---|
| Card ID (required) | Text | The Trello card ID. |
| URL (required) | Text | The URL to attach to the card. |
| Attachment name | Text | A label for the attachment (optional). |
Settings for Board · List
No further settings.
Settings for List · List
No further settings.
Showing settings for Card · Create
- List ID and Target list ID are the id of a list (a column), not of a board. Run Board → List, then List → List with your Board ID, and copy the
idof the list. - Board ID can also be the short code in a board’s address:
https://trello.com/b/AbC123xY/my-boardgivesAbC123xY. - Card ID comes from the
idof a Card → Create result, for example{{ $('Trello').id }}, or from the short code in a card’s address (https://trello.com/c/<code>/…). - Position puts the new card at the
ToporBottomof the list.
Outputs
Section titled “Outputs”-
Output
- Card → Create, Update and Move return the card, including its
id,name,desc,idListandurl(the link to open it in Trello). - Card → Attach URL returns the new attachment, with its
id,nameandurl. - Board → List returns one item per board with
id,nameandurl; List → List returns one item per list withidandname.
Dependencies and credentials
Section titled “Dependencies and credentials”- Credential (connection, Basic Auth): required. See Connect Trello.
Trello uses an API key and a token, saved together as a Basic Auth credential:
- Open trello.com/app-key while signed in to Trello. If Trello asks you to create a Power-Up first, create one in its admin page; its API key tab gives you the key.
- Copy the API key.
- Next to the key, follow the Token link, allow access, and copy the token.
- Create a Basic Auth credential with the API key as Username and the token as Password. See Create a credential.
The token can act on all your boards, so keep it private.
Example workflow
Section titled “Example workflow”- A Context Menu trigger adds “Add to Trello” to the right-click menu.
- Get Page Metadata reads the page’s
titleandurl. - Trello, Card → Create, List ID of your “Ideas” list, Card title
{{ $input.title }}, Source URL{{ $input.url }}, PositionTop. - Browser Notification shows
Card added, with the card’s{{ $input.url }}.
Common issues
Section titled “Common issues”- “Trello needs a Basic Auth credential with the API key in Username and the token in Password.” The credential is missing a value or is not Basic Auth. Fill both fields.
- “Trello API Error: 401 … the API key or token is invalid or expired”. The key and token do not belong together, are swapped, or the token was revoked. Generate a new token next to your key and update the credential.
- “Trello API Error: 400 … invalid id”. A List ID, Card ID or Board ID is wrong. A board id was probably used where a list id is needed; use List → List to get list ids.
- The run is blocked in the web app. Trello runs through the browser extension. Install the extension and allow Trello for this workflow when asked, or run the workflow from the extension. See Running extension-only integrations in the web app.
Related nodes
Section titled “Related nodes”- Todoist: personal tasks with due dates.
- Linear: issues for software teams.
- Get Page Metadata: the page’s title and address for the card.
- Http Request: labels, checklists and other Trello features this node does not cover.