Send the bug to the column your team actually watches
Connect a Trello API key and token, pick the board and the list once, and a tester files a card from inside the session — description written, screenshot attached, short link back to the run.
API key and token · no Power-Up to install
Checkout total wrong on Android 14
screenshot.png attached
Open the run →
- No Power-Up
- an API key and a token
- Board → list
- a card lands in a column, not a board
- Three fields set
- idList, name and desc — nothing else
- Encrypted at rest
- AES-256-GCM, never read back
What gets filed, and how
Every filing is one card, built from the title and body the tester typed and the capture they were looking at.
A card on the list you pick
One card lands in the list you chose when you connected. A Trello card cannot live on a board in general; it lives in a column, so idList is the one thing filing cannot do without.
The failure, in the description
The title you typed becomes the card name; the body — steps, expected result, actual result and a link back to the run — becomes the card description.
The screenshot, as an attachment
The capture is uploaded to the new card as a card attachment, then discarded on our side — it is never written to our object storage. Over the attachment ceiling or refused, the card is still created and the result tells you it did not attach.
Three fields, and nothing else
createIssue sends idList, name and desc. No labels, members, due dates, checklists, cover, position in the list or custom fields — a Trello automation on the receiving list is the better place for any of those.
A key and a token, in the query string
Trello authenticates with two values — an API key and a token — carried in the query string of every request rather than a header. They are easy to swap; when one is wrong the message names both. Both are stored AES-256-GCM encrypted and never read back.
Connect, not migrate — set up once by an admin
An administrator connects the key and token and picks the board and list once; that list is stored as the organisation default and every filing uses it. Integrations connect to the Trello you already run — they do not migrate anything into it.
The exact shape of the card
Filing POSTs one card with a list, a name and a description, and attaches the screenshot. The fields it leaves alone are the half a reader is shopping for, so here they are by name.
Set on every card
- idList — the list you chose
- name — the title you typed
- desc — the body you wrote
- Attachment — the screenshot on the card
Left alone
- Labels and members
- Due date and checklist
- Cover and position in the list
- Custom fields
Not touched at all
- Power-Up data — we create a card through Trello’s API and read, write or configure nothing a Power-Up adds.
- Status read-back — filing is one-way; moving, archiving or completing the card changes nothing on our side and nothing polls the board.
Frequently asked questions
Yes. A tester files a card into the list you chose straight from the session — the title and description written and the screenshot attached. Filing is one-way, and every card lands in that one list.
Trello's API authenticates with a key and a token together: the key identifies the application, the token identifies you and what you have allowed it to do. They are generated in different places and easy to mix up, the single most common setup mistake, so a wrong one comes back naming both rather than saying authentication failed. Both travel in the query string of every request rather than an authorisation header, which means an unhandled error object from a Trello call would carry the key and the token inside the request URL it reports on itself. Every call this adapter makes is therefore converted into a plain, message-only error before it can travel anywhere — a deliberate rule for this adapter specifically. Both values are encrypted at rest with AES-256-GCM and never returned by any endpoint. Trello attributes the card to the account whose token you connected, so use a service account if that attribution matters to you.
The one you chose when you connected. A Trello card has to live in a list, so the destination picker has two levels: it shows your open boards first, then the open lists on the board you pick. That list is stored as the organisation default and every filing uses it — there is no routing by product, platform or severity. Trello returns the new card's short URL, which is what we store and show, so the tester can open the card and whoever triages can follow the link back to the run.
The card is created with a list, a name and a description, and nothing else: no labels, no members, no due date, no checklist, no cover, no custom fields and no control over where in the column it appears. A Trello automation on the receiving list can add those after the card arrives, which is the better place for that rule to live anyway.
Yes, as a card attachment. The image travels with the filing request, is uploaded to the new card and is then discarded on our side — it is never written to our object storage. The card is created first and the image attached second, so if it exceeds the attachment ceiling or Trello refuses it, you still get the card and a note that the screenshot did not attach.
Trello answers with a bare 'invalid id', which is turned into a plain message telling you the list no longer exists and to choose another destination on the Project management page. A 401, or the bare bodies 'invalid key' or 'invalid app token', become an instruction to reconnect that names both the key and the Token so you know there are two values to check. Anything else is passed through in Trello's own words, and a status line, host name or stack trace never reaches the screen.
Filing is one-way — nothing watches the board and nothing reads a status back; what we keep is the link between the session or scan, the card id and the short URL Trello returns. An organisation holds one project-management connection and one defect-tracker connection, and both can be active together; the filing dialog asks which one you want. Connecting a second project-management tool replaces Trello rather than sitting alongside it.
Put the next bug straight on the board
Connect a key and a token, choose the list, and file from the session. The full set of tools we can file into is on the integrations page.