Menu

Mattering Automations Trello integration

Connect Trello to Mattering Automations: boards, lists, cards, checklists, labels, members, comments, URL attachments, and webhook management as workflow steps, authenticated with a Trello API key and member token.

The Mattering Automations Trello integration adds Trello to your automation canvas: list and search boards, create, update, move, and archive cards, manage lists, checklists and check items, labels, card members, and comments, attach links by URL, and manage the webhook subscriptions that push Trello events to a URL you choose.

Setup takes a few minutes: get an API key and a member token from Trello's Power-Up admin console, attach them as a credential in Mattering, and test the connection. This guide walks through each step and ends with the full node reference.

The integration is honest about what can be undone. Closing a board and archiving a card or list are reversible and ship as their own nodes: Trello: Close / Reopen Board, Trello: Archive / Unarchive Card, and Trello: Archive / Unarchive List. The eight delete nodes are flagged destructive because Trello deletes are permanent, with no trash and no recovery. Verify the integration with read nodes only, and keep the delete nodes behind a condition, an approval step, or a manual run.

Before you start

  • A Trello account. The free plan covers everything in this integration except due dates and assignees on check items, which are a Trello Premium feature.
  • Access to Trello's Power-Up admin console at trello.com/power-ups/admin, which is where the API key and token come from.
  • A Mattering workspace with access to the Automations app.
  • For receiving Trello events: a Mattering Automations inbound webhook trigger to use as the webhook callback URL.

Create a Trello API key and member token

Mattering authenticates to Trello with two values: an API key, which identifies the app, and a member token, which authorizes it to act as your Trello member. Both come from the Power-Up admin console; no OAuth flow is involved. Trello sends them as query parameters on every request, and the integration handles that shape safely, as covered in the connect step.

Open trello.com/power-ups/admin and create a new Power-Up, or open one you already have. An empty Power-Up created just to hold the key is fine; no code is involved.
On the Power-Up's API key page, generate the key if needed and copy it.
Click the Token link shown beside the API key, review the access being granted, authorize it, and copy the member token.
The token acts as your Trello member: everything workflows do with it is done as you, with the read and write access granted at authorization. Trello has no finer scopes, so treat the token like a password, and revoke it and generate a new one if it is ever exposed.

Connect Trello to Mattering

In Mattering Automations, open Connectors and click Add Connector.
Choose Trello from the list.
Click Create new credential. The form shows generic labels: enter the API key in the Username field and the member token in the Password field, then save.
The credential is stored encrypted in Google Secret Manager and never appears in workflow logs. Trello receives the two values only as query parameters, and the integration keeps them off every loggable surface: they are never concatenated into URL strings, error messages and logged lines are scrubbed of both values, both halves are registered with the execution's redaction layer, and node configuration cannot override or expose them.
Click Test Connection: Mattering fetches your Trello member profile and reports the connected member by name. A wrong credential comes back as a readable invalid key or invalid token message, which tells you which half to fix.
Click Connect. All 45 Trello nodes appear in your canvas palette.

Verify it works

After connecting, open any automation canvas and check the palette: a Trello section should list the query and action nodes. Drop Trello: Get My Member onto the canvas and run a test step. It takes no configuration and is a safe, read-only call; a successful response returns your member id, username, and full name, and exercises both halves of the credential in one request.

To confirm the rest of the surface, run Trello: List My Boards and note a board id, then point Trello: List Lists on Board and Trello: List Cards on Board at it. Board and card ids accept both the 24-character id and the short token from a trello.com board or card URL. Everything in the verify path is read-only; nothing here touches the eight delete nodes.

Node reference

45 nodes, generated from the connector itself so this reference always matches what ships.

Read and query nodes 15

Trello: Get Board

trello_get_board

Get a single board with its name, description, closed state, preferences, and label names. Optional nested resources pull the board's lists, cards, labels, and members in one call.

Trello: Get Card

trello_get_card

Get a single card with its name, description, due date, labels, and badges. Optional nested resources pull the card's attachments, members, checklists, and comment actions in the same call.

Trello: Get List

trello_get_list

Get a single list: name, position, closed state, and the id of the board it belongs to.

Trello: Get My Member

trello_get_me

Get the authenticated Trello member: id, username, full name, and the ids of their boards and Workspaces. Needs no configuration, so it doubles as the credential health check (401 when the key or token is wrong).

Trello: List Board Members

trello_list_board_members

List the members of a board with their ids, usernames, and full names. The returned member ids feed card assignment.

Trello: List Card Attachments

trello_list_card_attachments

List a card's attachments: name, URL, whether it was an upload or a link, and the attachment id used by Delete Attachment.

Trello: List Card Comments

trello_list_card_comments

List a card's comments (commentCard actions), newest first. Each entry carries the comment text under data.text plus the commenting member; the action id feeds Delete Comment.

Trello: List Cards in List

trello_list_list_cards

List the cards in a single list (column), in board order. The classic polling read for column-driven automations.

Trello: List Cards on Board

trello_list_board_cards

List the open cards on a board across all of its lists. For one column only, use Trello: List Cards in List instead.

Trello: List Checklists on Card

trello_list_card_checklists

List a card's checklists with their check items and states. The returned checklist and check item ids feed the check item nodes.

Trello: List Labels on Board

trello_list_board_labels

List a board's labels with their names and colors. The returned label ids feed card labeling and label updates.

Trello: List Lists on Board

trello_list_board_lists

List the lists (columns) on a board, open ones by default. Optionally include each list's cards inline. The returned list ids feed card creation and moves.

Trello: List My Boards

trello_list_my_boards

List the boards the authenticated member belongs to. Filter by open, closed, starred, or organization membership. The returned board ids feed every board-scoped node.

Trello: List Webhooks

trello_list_webhooks

List every webhook registered on this connector's token, with each webhook's model, callback URL, active flag, and failure count. The token in the path is filled in by the connector from the stored credential; it is never part of the node's configuration or output.

Trello: Search

trello_search

Search across the member's cards, boards, members, and Workspaces with Trello's search operators (board:, list:, label:, due:, @member, and friends). Results come back grouped by model type.

Action nodes 30

Trello: Add Check Item

trello_add_checkitem

Add an item to a checklist, optionally already checked, with a due date or an assigned member (due dates and assignees on check items are a Trello Premium feature). Returns the created check item.

Trello: Add Comment to Card

trello_add_comment

Post a comment on a card as the token's member. Returns the created commentCard action; its id is what Delete Comment takes.

Trello: Add Label to Card

trello_add_label_to_card

Add one existing label to a card without touching the card's other labels. Removing it again restores the exact previous state.

Trello: Add Member to Card

trello_add_member_to_card

Assign one board member to a card without touching the card's other members. Removing them again restores the previous state.

Trello: Archive / Unarchive Card

trello_archive_card

Archive a card, or send it back to the board with closed=false. Archived cards keep all their content and are recoverable from the board's archive; this is the reversible alternative to the destructive Delete Card node.

Trello: Archive / Unarchive List

trello_archive_list

Archive a list, or restore it with value=false. Archiving hides the list (and its cards) from the board without deleting anything; Trello has no list delete at all, so archive is the terminal state and it is fully reversible.

Trello: Attach URL to Card

trello_add_attachment_url

Attach a link to a card by URL. This connector attaches by URL only (Trello stores the link, isUpload stays false); the API's multipart file upload is deliberately not exposed because the canvas cannot produce file bytes.

Trello: Close / Reopen Board

trello_close_board

Close (archive) a board, or reopen it with closed=false. A closed board disappears from the boards page but keeps all lists and cards and can be reopened at any time. This is the reversible alternative to the destructive Delete Board node.

Trello: Create Board

trello_create_board

Create a new board. By default Trello seeds it with the To Do, Doing, and Done lists; turn that off with defaultLists=false to start empty. Returns the created board with its id.

Trello: Create Card

trello_create_card

Create a card in a list, with optional description, due and start dates, members, labels, and a source URL that becomes the card's first attachment. Returns the created card with its id and shortUrl.

Trello: Create Checklist

trello_create_checklist

Add a checklist to a card, optionally copying the items of an existing checklist with idChecklistSource. Returns the created checklist with its id.

Trello: Create Label

trello_create_label

Create a new label on a board with a name and one of Trello's named colors. Returns the created label with its id.

Trello: Create List

trello_create_list

Create a new list (column) on a board. Optionally copy an existing list's cards with idListSource. Returns the created list with its id.

Trello: Create Webhook

trello_create_webhook

Register a webhook: Trello will POST every action on the watched model (a board, list, or card id) to your callback URL. MANAGEMENT ONLY: this does not create an Automations trigger by itself; point callbackURL at an Automations inbound webhook trigger URL to receive the events. At creation Trello sends an HTTP HEAD request to the callback and requires a 200 response, or the webhook is not created. Failed deliveries are retried 3 times; a callback answering 410 deletes the webhook.

Trello: Delete Attachment

trello_delete_attachment

DESTRUCTIVE: delete an attachment from a card. A link attachment could be re-added, but a FILE that was uploaded to Trello is permanently gone, so the node is flagged for the worst case it can hit.

Trello: Delete Board

trello_delete_board

DESTRUCTIVE: permanently delete a board and every list and card on it. There is no undo and no trash; a deleted board cannot be recovered by Trello support either. If the board might be needed again, use Close / Reopen Board instead.

Trello: Delete Card

trello_delete_card

DESTRUCTIVE: permanently delete a card with its comments, checklists, and attachments. There is no undo. If the card might be needed again, use Archive / Unarchive Card instead.

Trello: Delete Check Item

trello_delete_checkitem

DESTRUCTIVE: delete a single check item from a checklist. There is no undo; to keep the item but clear it, use Update Check Item with state=incomplete instead.

Trello: Delete Checklist

trello_delete_checklist

DESTRUCTIVE: delete a checklist and every check item on it. There is no undo and no archive state for checklists.

Trello: Delete Comment

trello_delete_comment

DESTRUCTIVE: delete a comment from a card. Only comment actions can be deleted, only by their author or a board admin, and there is no undo.

Trello: Delete Label

trello_delete_label

DESTRUCTIVE: delete a label from its board, stripping it from every card that carries it. There is no undo; to take it off one card only, use Remove Label from Card.

Trello: Delete Webhook

trello_delete_webhook

DESTRUCTIVE: delete a webhook subscription. Delivery stops immediately and the deletion cannot be undone; an equivalent webhook can be recreated with Create Webhook, but it arrives as a new object and events during the gap are lost.

Trello: Move Card

trello_move_card

Move a card to another list (and optionally another board), with an optional position in the destination. The ergonomic shortcut for the most common Trello automation step; moving it back reverses it exactly.

Trello: Remove Label from Card

trello_remove_label_from_card

Take one label off a card. The label itself survives on the board and can be re-added, so this is a reversible write, unlike Delete Label.

Trello: Remove Member from Card

trello_remove_member_from_card

Unassign a member from a card. The member keeps their board access and can be re-added, so this is a reversible write.

Trello: Update Board

trello_update_board

Update a board's name, description, closed state, Workspace, or subscription. Preference fields (prefs/{name}) go through extra_query. Returns the updated board.

Trello: Update Card

trello_update_card

Update any card fields: rename, edit the description, change dates, replace the member or label sets (idMembers and idLabels REPLACE the existing sets), archive with closed, or relocate with idList/idBoard/pos. Returns the updated card.

Trello: Update Check Item

trello_update_checkitem

Update a check item, most importantly its state (complete or incomplete): this is the check/uncheck node. Trello scopes the update to the CARD, so both the card id and the check item id are required.

Trello: Update Label

trello_update_label

Rename a label or change its color. The change applies everywhere the label is used on the board.

Trello: Update List

trello_update_list

Rename or reposition a list, move it to another board with idBoard, or change the acting member's subscription. Returns the updated list.

Using the integration

On the automation canvas

Trello nodes chain with every other node: a scheduled Trello: List Cards in List sweep can compare a column against a Mattering database and close the matching task in Mattering Productivity when a card reaches Done, a form submission can become a card via Trello: Create Card with a comment and a source link attached, and Trello: Move Card handles the single most common Trello automation step, exactly reversibly.

From AI assistants over MCP

Every node speaks MCP, the open protocol for connecting AI assistants to tools. Claude, ChatGPT, and Matter can list boards, read cards, search across the workspace with Trello: Search, and create or move cards through the same nodes your workflows use. The fifteen query nodes are read-only, which makes them the safest Trello surface to hand an agent.

Archive and close instead of delete

Trello draws a hard line between reversible and permanent, and the integration keeps it visible. Trello: Close / Reopen Board and Trello: Archive / Unarchive Card preserve everything and can be undone at any time. Trello: Delete Board and Trello: Delete Card are permanent, with no trash and no recovery, and are flagged destructive along with the other delete nodes. Lists are the special case: Trello has no list delete at all, so Trello: Archive / Unarchive List is their terminal state, and it is fully reversible.

Incremental writes versus Update Card

The idLabels and idMembers fields on Trello: Update Card replace the whole set, per Trello's API semantics. For one-at-a-time changes use Trello: Add Label to Card, Trello: Remove Label from Card, Trello: Add Member to Card, and Trello: Remove Member from Card: each changes exactly one thing, and running the counterpart restores the previous state exactly.

Attachments by URL

Trello: Attach URL to Card stores a link on the card; Trello's multipart file upload is deliberately not exposed, so URL is the only path and workflow payloads stay light. Deletion is the asymmetric part: Trello: Delete Attachment is flagged destructive because a link attachment can be re-added but a file that was uploaded to Trello is permanently gone, and the node cannot tell which kind it is removing.

Webhooks: management nodes plus an inbound trigger

Trello: Create Webhook, Trello: List Webhooks, and Trello: Delete Webhook manage subscriptions; they are not triggers by themselves. To receive events, create a Mattering Automations inbound webhook trigger and pass its URL as the callback in Trello: Create Webhook: Trello then POSTs every action on the watched board, list, or card to it. At creation Trello sends an HTTP HEAD request to the callback and requires a 200 response, failed deliveries are retried three times, a callback answering 410 deletes the webhook, and sustained failure disables it.

Troubleshooting

Test Connection fails
Check the field mapping first: the API key goes in the Username field and the member token in the Password field, and both are required. Trello answers a bad credential with a plain invalid key or invalid token message, which names the half to fix. Also check for stray whitespace picked up when pasting either value.
Nodes return 401 after working before
The member token has stopped being valid, most often because it was revoked. Generate a fresh token with the Token link beside the API key in the Power-Up admin console and update the credential on the connector. Revoking a token also deletes the webhooks registered with it, so run Trello: List Webhooks and recreate any you still need after swapping tokens.
Requests fail with 429 responses
Trello rate-limits per key and per token: 300 requests per 10 seconds for an API key, 100 per 10 seconds for a token, and a stricter 100 per 900 seconds on member endpoints. The nodes do not retry automatically. Space scheduled sweeps out, and prefer the nested resources on Trello: Get Board and Trello: Get Card over many single-object calls.
Updating a card wiped its labels or members
The idLabels and idMembers fields on Trello: Update Card replace the entire set; passing one id leaves the card with only that one. That is Trello's API semantics, not a defect. For additive changes use Trello: Add Label to Card or Trello: Add Member to Card, and their remove counterparts, which touch exactly one thing at a time.
Trello: Create Webhook fails at creation
Trello sends an HTTP HEAD request to the callback URL at creation and requires a 200 response, or the webhook is not created. A Mattering Automations inbound webhook trigger URL satisfies this check; if the callback points anywhere else, make sure that endpoint is publicly reachable and answers HEAD with a 200.
A webhook went quiet
Run Trello: List Webhooks and check the active flag and failure count. Failed deliveries are retried three times and then dropped, a callback answering 410 deletes the webhook outright, revoking the token deletes its webhooks, and sustained consecutive failure disables the subscription. Fix the callback first, then recreate the webhook with Trello: Create Webhook; events that occurred during the gap are not replayed.
Trello: Update Check Item returns a 404
Check item state updates are scoped to the card in Trello's API, so the node needs both the card id and the check item id; a checklist id in the card field finds nothing. Get the ids from Trello: List Checklists on Card, which returns each checklist with its check items and their states.
Add Check Item is refused when setting a due date or assignee
Due dates and assigned members on check items are a Trello Premium feature, so on a free plan Trello: Add Check Item works only without them. Create the item with its name and checked state alone, or carry the date on the card's own due date field instead.

Trello is a trademark of its respective owner. Mattering uses platform names to identify the services these integrations connect to; no endorsement or affiliation is implied.

Start Free Explore our Products