See the Channel Catalog to see which Plans have access to this channel.
Trello is a web-based, Kanban-style, list-making application. Trello is a collaboration tool that organizes your projects into boards. Trello brings a visual perspective to projects, allowing you to see the status of who’s working on what, and what needs to get done in a single glance.
How to Connect
- On the My pipelines page, click Create a pipeline. Enter name, description, and tag fields and click the Create Pipelines button. The pipelines wizard displays:
- From the wizard you choose the connections for the first steps of your pipeline. When you choose a type, you'll add the channels and steps for your first steps. You can always add more steps later. A Triggered pipeline is started by a specific event in real-time. A Scheduled pipeline will start according to a schedule. A Manual pipeline only starts manually. Once you've completed the wizard, you'll be prompted for connection detail, if necessary. If you are an experienced builder, click the Start from scratch button and then from the right side of the page, choose the All to list all available channels.
Connect to Trello
- On the right side of the page, choose All to list all channels enabled for your realm. Make sure Trello is enabled.
- Expand Trello and click Connect to Trello. You will see a dialog form that asks you to authorize Pipelines. Click on Connect to Trello.
- You will be prompted with the following screen. Trello will ask you if you grant QuickBase access to your profile. Click on Log In.
- After that you will be redirected to the Trello Login page and asked to log in with email and password or credentials using other platforms.
How to reconnect
You may need to reconnect your account to a channel. Reasons may be (but not limited to):
- If you need to connect a different account.
- Authorization updates, such as a changed password.
- Editing the access rights that Pipelines has to the channel.
- Select a pipeline that already has this channel in it.
- Open a step that contains this channel.
- Under account, select Connect (or reconnect) and follow the process above, How to connect.
The steps you can use with Trello fall under five categories: Board, List, Card, Comments, and Attachments.
Note: You cannot use jinja expressions in trigger conditions unless explicitly specified as possible.
|Action||Look Up a Board||Returns a single Board for the selected ID.|
|Query||Search Boards||Lists Boards applying the specified filters.|
|Action||Create Board||Creates a new board.|
|Action||Update Board||Updates a board.|
|Action||Delete Board||Deletes a board.|
|Action||Look Up a List||Returns a single List for the selected ID.|
|Query||Search Lists||Gets Lists in the given Board, applying optional filter conditions.|
|Action||Create List||Creates a new List.|
|Action||Update List||Updates a List.|
|Action||Archive a List||Archives a list.|
|Action||Unarchive a List||Unarchives a list.|
|Action||Move List to Board||Moves a List to a different Board|
|Trigger||Card Created||Triggers when a new Card is created in the specified Board.|
|Trigger||Card Updated||Triggers when a Card is updated in the specified Board.|
|Trigger||Label Changed||Triggers when a Label is added or removed to/from a Card.|
|Trigger||Membership Changed||Triggers when a Member is added or removed to/from a Card.|
|Trigger||Card Moved||Triggers when a Card is moved to a different List or Board.|
|Action||Look Up a Card||Returns a single Card for the selected ID.|
|Query||Search Lists||Lists Cards in the given Board and List, applying optional filter conditions.|
|Action||Fetch a Linked Card||Fetches a linked card.|
|Action||Create Card||Creates a new Card.|
|Action||Update Card||Updates an existing Card.|
|Action||Delete a Card||Deletes an existing Card.|
|Action||Move a Card||Moves a Card to another Board or List.|
|Action||Subscribe to a Card||Subscribes to a card to get notifications when something changes.|
|Action||Unsubscribe from a Card||Unsubsribes from Card notifications.|
|Action||Archive a List||Archives a list.|
|Action||Unarchive a List||Unarchives a list.|
|Action||Create new Label||Creates a new Label on an existing Card.|
|Action||Add Label||Adds a Label to an existing Card.|
|Action||Remove Label||Removes a Label from an existing Card.|
|Trigger||New Comment||Triggers when a new comment is created in the given board.|
|Action||Look Up a Comment||Returns a single Comment for the selected ID.|
|Query||Search Comments||Lists Comments in the given Board and Card, applying optional filter conditions.|
|Action||Add a Comment||Adds a new comment to the specified card.|
|Action||Delete a Comment||Deletes an existing Comment.|
|Trigger||New Attachment||Triggers when a new Attachment is added to a Card in the specified Board.|
|Action||Add an Attachment||Adds an Attachment to the specified Card.|
|Query||Search Attachments||Lists Attachments in the given Board and Card, applying optional filter conditions.|
|Action||Delete Attachment||Deletes an existing Attachment.|
Trello limits the number of objects that can exist on a board or card. The limits for each type of object and whether they are limited at the card or board level are available via the cards and boards API resources.
Notice: Limits may vary by boards and accounts. You should adjust your application to handle the responses and their values appropriately.
There are a number of objects in Trello that are limited at the board level. For instance, to see the limits that exist on a board, we can make the following request:
The following enumerated limits for cards can be taken from the returned response:
The first set of values for the key
openPerBoard indicates that Trello allows for 5000 open cards to exist per a board and that the Trello clients (web, mobile, desktop) will begin to warn users when they have 4500 cards open on a bard. The second object for key
totalPerBoard means that Trello allows for 2000000 total cards (open or closed) to be on a board and that the clients will begin warning when there are 1800000.
disableAt limit is the count at which the clients will no longer allow users to add objects of that kind. The status field indicates whether the board is in violation of the current limits. In this case, the board hasn't exceeded these limits. When a board has exceeded one of the types of limits, the status will change and a count field and value appear.
For example, if our board were to have more cards than allowed for by the
disableAt the limits would be updated:
Similarly, if the count is above the
warnAt limit, the status will change to warn.
Additionally, there is a maximum number for each limit above which the API will return an error if more objects are attempted to be added. The status of objects that exceeded the limits prior to their creation is
We can also see limits that are specific to cards by including limits as a value for the fields query parameter when making requests to card resources:
The received response will look similar to the boards-level limits. The card-level limits function the exact same as the board-level limits outlined above.
Webhooks and Limits
In addition to limiting the number of different types of objects that can exist on a board or card, Trello disallows creating new webhooks on objects that have exceeded their limits.
Attempting to create a webhook on an object that has exceeded its limits will result in the following error message: HTTP/1.1 500 Model exceeds limits. Webhooks that exist on models that have a limit status of
maxExceeded will be deleted.
API Rate Limits
To help prevent strain on Trello’s servers, Trello’s API imposes rate limits per API key for all issued tokens. There is a limit of 300 requests per 10 seconds for each API key and no more than 100 requests per 10 second interval for each token. If a request exceeds the limit, Trello will return a 429 error.
For more detailed information about Trello restrictions and limitations click here.
Use case examples
The following are some example of using the Trello channel.
In this example, a Quickbase app that contains information about tasks that need to be done. It would be convenient every time we update a card in Trello to transfer that information to the Quickbase app. If the card is not in the QB table a new record would be created, otherwise the card information would be updated. The following example shows the steps to create this pipeline.
First you must create a Quickbase application that has a table containing records with the following fields:
Create a new pipeline and connect to your Trello and Quickbase profiles.
The first step to be added is Card Updated from Trello. This step would trigger whenever someone updates a card in the specified board.
The second step to be added is Search Records from Quickbase. Fill in the required information and add a condition to search by ID, which is taken from the trigger step.
In the Loop statement after the search step add a new Update Record step from Quickbase and fill in the information from the trigger step.
Now, click Insert a Condition to add an IF statement to check if the search step has returned an empty list.
If the list is empty, then add a new Create Record step from Quickbase and fill in the information. The Else clause will remain empty.
After triggering the pipeline we see the following in our Activity log: