• Documentation >
• Apps >
• Productivity >
• Trello

Trello

Getting started with Trello

Prerequisites

• A Trello account

In order to use Trello with Ibexa Connect, you must have a Trello account. If you do not have one, you can create a Trello account at trello.com/signup.

Connecting Trello to Ibexa Connect

To connect your Trello account to Ibexa Connect follow the general instructions for Connecting to services.

After you click the Continue button, Ibexa Connect will redirect you to the Trello website where you will be prompted to grant Ibexa Connect access to your account.

Confirm the dialog by clicking Allow.

Triggers

Watch Activities

Triggers instantly when one or more selected actions are performed.

Webhook name	Enter the name of the webhook.
Watched objects	Select whether you want to watch a Board, List, or Card.
Board	Select the board you want to watch for activities.
Watch activities	Select the actions you want to watch.
Description	Enter the webhook description.

Watch Boards

Triggers when a new board is created.

Limit	The maximum number of boards Ibexa Connect will return during one execution cycle.

Watch Activities

Triggers when one or more selected actions are performed.

Watched objects	Select whether you want to watch a Board, List, or Card.
Board	Select the board you want to watch for activities.
Watch activities	Select one or more actions you want to watch.
Limit	The maximum number of activities Ibexa Connect will return during one execution cycle.

Watch Notifications

Triggers when you receive a new notification.

Limit	The maximum number of notifications Ibexa Connect will return during one execution cycle.

Watch Comments

Retrieves comment details when there is a new comment in a specified location.

Watched object	Select whether you want to watch a Board, List, Card, or All Cards Everywhere.
Limit	The maximum number of comments Ibexa Connect will return during one execution cycle.

Watch Attachments

Triggers when a new attachment is added to a card.

Board	Select the board where the card you want to watch for attachments is located.
List	Select the list that contains the card you want to watch for attachments.
Card	Select the card you want to watch for attachments.
Limit	The maximum number of attachments Ibexa Connect will return during one execution cycle.

Actions

Edit a Board

Edits the settings of an existing board.

Board ID

Enter the ID of the board to update. The Board ID can be retrieved using, for example, the Watch Boards module.

New name

Enter a new name for the board.

New description

Enter the board description if needed.

Organization ID

Enter the ID of the organization. The ID can be retrieved, for example, using the Watch Activities module.

Subscribe

Select whether the acting user is subscribed to the board.

Permission level

Boards have different Voting/Commenting rules for each permission level. For example: If your board is Private and you select the Voting/Commenting rule to be for All, you will receive an error. Here is a table of rules per permission level:

Permission level	Voting/Commenting rule
Private	Nobody, Members, Members, and Observers
For organization	Nobody, Members, Members, and Observers, Organization Members
Public	Nobody, Members, Members and Observers, Organization Members, All

Voting

Select who can vote on this board. Whether nobody, members, members and observers, organization members, or public. See above for the table of rules.

Comments

Select who can comment on cards for this board. Whether nobody, members, members and observers, organization members, or public. See above for the table of rules.

Invitations

Select who can invite people to this board.

Self-join

Select whether team members can join the board themselves or they have to be invited.

Card covers

Select whether card covers should be displayed on this board or not.

Background

Select the color of the background or the custom background.

Note

The custom background is available only to Trello Gold and Business Class subscribers.

Background ID

Enter the Background ID if the custom background option was selected.

Card aging

Select between two modes of card aging: “Regular” and “Pirate”. In regular mode, cards become progressively more transparent and “fade out” the longer they remain untouched. In pirate mode, cards will tear, yellow, and crack like an old pirate map.

Calendar feed enabled

Select whether the calendar feed is enabled or not.

Color label name

Assign a name to the desired color label.

Archive

If this option is disabled, the board will be closed.

Get a Board

Retrieves a board's details.

Board ID	Enter (map) the ID of the board you want to retrieve information about.

Get a List

List ID	Enter the ID of the list you want to retrieve information about.

Delete a Label

Label ID	Enter the ID of the label you want to delete. The ID can be retrieved, for example, using the Retrieve Labels module.

Remove a Label from a Card

Enter card ID and label ID	Choose whether you want to enter IDs manually or select the label from the drop-down menu.

Add a Member to a Card

Enter card ID and member ID	Choose whether you want to enter IDs manually or select a card and member from the drop-down menu.

Create a Checklist Item

Adds an item to a checklist.

Enter Checklist ID	Choose whether you want to enter (map) IDs manually or select a checklist from the drop-down menu.
Item name	Enter a name for the new item.
Position	Select whether you want to add the item to the top or append to the bottom of the checklist.
* Checked *	Enable this option if you want to add the item as already checked.

Edit a Checklist Item

Updates an item on a checklist on a card.

Enter a Card ID and Checklist Item ID	Enter (map) the ID of the card you want to edit manually or select it from the menu.
Card ID	Enter (map) the card that contains the checklist item you want to update.
Checklist Item ID	Enter (map) the checklist item you want to update.
Move to Checklist/Checklist ID	Select or map to the checklist you want to move the checklist item to.
Item Name	Enter the new name of the checklist item.
Position	Select whether you want to place the item in the top or at the bottom of the checklist.
State	Set the state of the checklist item.

Remove an Item from Checklist

Removes a specified item from the checklist.

Checklist ID	Enter (map) the checklist you want to remove an item from.
Checklist item ID	Enter (map) the item you want to remove from the checklist.

Delete a Checklist

Deletes a specified checklist.

Checklist ID	Enter (map) the checklist you want to delete.

Get a Card Checklist

Retrieves checklists' details from a specified card.

Enter Card ID	Choose whether you want to enter (map) IDs manually or select a card from the drop-down menu.
Card ID	Enter (map) the ID of the card you want to retrieve checklists from.
Limit	Enter the number of checklists Ibexa Connect will return during one execution cycle.

Watch Cards Moved to List

Triggers when a card is moved to a list.

Board ID	Select the board that contains the list you want to watch.
List	Select the list you want to watch for moved cards.
Limit	Enter the maximum number of results Ibexa Connect will return during one execution cycle.

Create a List

Board ID	Map or select the board you want to create a list in.
Name	Enter a name for the new list.
Position	Select whether you want to add the list to the top or append to the bottom of the card.
List ID	Enter the ID or map the ID of the list you want to copy into the new list.

Add a Label to a Card

Adds a label to a selected card.

Enter card ID	Choose whether you want to enter (map) IDs manually or select a card from the drop-down menu.
Label	Select the label you want to add to the selected card from the drop-down menu

Add an Attachment

Enter card ID	Choose whether you want to enter (map) IDs manually or select a card from the drop-down menu.
Attachment type	Select whether you want to provide the file from the URL or manually (e.g. from a previous module).

Archive or Unarchive a Board

Closes or re-opens a selected board.

Board ID	Enter (or map) the ID of the board you want to close or re-open.
Archive or unarchive	Select whether you want to close (archive) or re-open (unarchive) the board.

Archive or Unarchive a Card

Archives or sends a card back to the board.

Card ID	Enter (or map) the ID of the card you want to archive or send back to the board.
Archive or unarchive	Select whether you want to close (archive) or re-open (unarchive) the card.

Delete a Card

Deletes a card.

Card ID	Enter (or map) the ID of the card you want to delete.

List Attachments

Retrieves attachments on a card.

Card ID	Enter (or map) the ID of the card you want to retrieve attachments from.

Get an Attachment

Retrieves attachment details.

Card ID	Enter (or map) the ID of the card you want to retrieve attachments from.
Attachment ID	Enter or select the attachment you want to retrieve.

Archive or Unarchive a List

List ID	Enter (or map) the ID of the list you want to archive or unarchive.
Archive or unarchive	Select whether you want to archive the list or send the list back to the board (unarchive).

Assign a Member to a Board

Board ID	Select the board where you want to add a member.
Email address	The email address of the member you want to add to the board.
Member type	Select the type of member you want to add to the board. Admin A board admin is a member of the board who can do anything on the board. Normal A normal member is simply a member of the board. Observer An observer is a member with read-only access to the board. (Observers are only available to teams with Trello Business Class).
Full name	Enter the full name of the user you want to add to the board.

Create a Board

Creates a new board.

Name

Enter the name of the new board.

Description

Enter the board description if needed.

Organization ID

Enter the ID of the organization. ID can be retrieved, for example, using the Watch Activities module.

Permission level

Boards have different Voting/Commenting rules for each permission level. For example: if your board is Private and you select the Voting/Commenting rule to be for All, you will receive an error. Here is a table of rules per permission level:

Permission level	Voting/Commenting rule
Private	Nobody, Members, Members, and Observers
For organization	Nobody, Members, Members, and Observers, Organization Members
Public	Nobody, Members, Members and Observers, Organization Members, All

Voting

Select who can vote on this board. Whether nobody, members, members and observers, organization members, or public. See above for the table of rules.

Comments

Select who can comment on cards for this board. Whether nobody, members, members and observers, organization members, or public. See above for the table of rules.

Invitations

Select who can invite other people to this board.

Self-join

Select whether team members can join the board themselves or they have to be invited.

Default labels

Select whether to use the default set of labels or not.

Default lists

Determines whether to add the default set of lists to the board (To Do, Doing, Done) or not.

Board source ID

Select or map the ID of the board to copy into the new board.

Card Covers

Select the Yes option if you want to enable the card covers for the board.

Background

Select the color of the background or the custom background.

Note

The custom background is available only to Trello Gold and Business Class subscribers.

Card aging

Select between two modes of card aging: “Regular” and “Pirate”. In regular mode, cards become progressively more transparent and “fade out” the longer they remain untouched. In pirate mode, cards will tear, yellow, and crack like an old pirate map.

Create a Card

Creates a card in a selected list.

Enter a List ID

Enter (map) the ID of the list you want to create a card for manually or select it from the menu.

Name

Enter a name for the new card.

Description

Enter the description for the card.

Labels

Enter the ID of the label you want to add to the new card. The ID can be retrieved, for example, using the Retrieve Labels module.

Position

Select whether you want to add the card to the top or append the card to the bottom of the list.

Due date

Enter a due date for the card. Supported date and time formats. Example: 06/20/2019 5:27 PM

Due complete

If this option is enabled the due date is marked complete.

Members

Add (map) the member IDs you want to add to the card.

File URL

A URL starting with http:// or https://

Source file

Allows you to upload a file as a card attachment.

Filename	Enter or map the file name, including the file extension.
File data	Enter or map the file data (from the previous module, e.g. Dropbox > Get a File or Google Drive > Get a File)

Note

There is a 10 MB file upload limit per attachment. However, Business Class and Trello Gold members have a 250 MB file upload limit per attachment.

Copy card

Select (or map) a card you want to create a copy of. If you don't specify the name, the name of the copied card is used. If you do specify the name (Name field above), the copied card is renamed.

Create a Comment in a Card

Adds a comment to a selected card.

Enter a Card ID	Enter (map) the ID of the card you want to create a comment for manually or select it from the menu.
Comment	Enter the comment you want to add to the selected card.

Create a Custom Field

In order to use custom fields, users need to enable the Custom Fields Power-Up.

Board ID	Select the board where you want to create a custom field.
Type	Select the custom field type. For more information about custom fields, refer to Getting Started with Custom Fields.
Name	Enter the custom field name.
Position	Determines the position of the custom field when viewing all custom fields for a board.
Display on front card	Enable this option to display the created custom field on the card front.

Create a Checklist

Enter a Card ID	Enter (map) the ID of the card you want to create a checklist for manually or select it from the menu.
Name	Enter the checklist name.
Position	Determine the position of the checklist on the card.
Enter checklist ID	Enter the ID of a source checklist to copy into the new one.

Create a Label

Board ID	Select the board you want to create a label for.
Name	Enter a name for the new label.
Color	Select the label color.

Get a Label

Label ID	Enter (map) the ID of the label.

Remove a Member from a Card

Enter card ID and member ID	Choose whether you want to enter IDs manually or select a card and member from the drop-down menu.

Delete a Comment in a Card

Comment ID	Enter the ID of the comment you want to delete. The ID can be retrieved e.g. with the Watch Comments module.

Delete an Attachment

Deletes an attachment from a card.

Enter card ID and attachment ID	Choose whether you want to enter IDs manually or select a card and attachment from the drop-down menu.

Edit a Card

Enter card ID	Enter (map) the ID of the card you want to edit manually or select it from the menu.
Name	Enter a name for the card.
Description	Enter the description for the card.
Move a card	Select the board and the list where you want to move the card.
Labels	Enter the ID of the label you want to add to the card. The ID can be retrieved, for example, using the Retrieve Labels module.
Position	Select whether you want to add the card to the top or append the card to the bottom of the list.
Due date	Enter a due date for the card. Supported date and time formats. Example: 06/20/2019 5:27 PM
Due complete	If this option is enabled, the due date is marked complete.
Members	Add (map) the member IDs you want to add to the card.
Attachment cover ID	The ID of the image attachment that the card should use as its cover.
Subscribe	Select whether the member should be subscribed to the card or not.
Archive	Select whether the card should be archived or not.

Edit a Comment in a Card

Comment ID	Enter the ID of the comment you want to edit. The ID can be retrieved e.g. using the Watch Comments module.
New comment	Enter the content of the new comment.

Edit a Label

Enter Label ID	Enter the ID of the label you want to edit. The ID can be retrieved, for example, using the Retrieve Labels module.
Name	Enter the new name for the label.
Color	Select the color for the label.

Edit a List

List ID	Enter the ID of the list you want to update.
Name	Enter a new name for the list.
Board ID	Map or select the board where the list should be moved to.
Position	Select whether you want to add the list to the top or append to the bottom of the card.
Subscribed	Enable this option if you want to subscribe the active member to the list.

Get a Card

Retrieves a selected card's details.

Board ID	Fill this field if you would like to see the names of the custom fields.
Enter card ID	Enter (map or select) the ID of the card you want to retrieve information about.

Get a Custom Field

Retrieves information about a selected custom field.

Enter custom field ID	Enter (map or select) the ID of the custom field you want to retrieve information about.

Get a Checklist

Enter checklist ID	Enter (map or select) the ID of the checklist you want to retrieve information about.

Set a Custom Field on a Card

Updates a custom field value.

Enter Card ID and Custom field ID	Enter (map or select) the ID of the card and custom field you want to edit.
Type	Select the custom field type. Note: The selected type must match the custom field type.

Value

Enter a new value for the custom field.

Note

The value should match the type selected. If you select 'type' = 'list' the value should be the ID of the custom field's option that you want to set the value to.

Unassign a Member from a Board

Removes a member from a board.

Board ID	Enter (map or select) the ID of the board you want to remove the user from.
Member	Select the member you want to remove from the board.

Make an API Call

Allows you to perform a custom API call.

URL

Enter a path relative to https://api.trello.com/1/ e.g. members/me

Note

For the list of available endpoints, refer to the Trello API Documentation.

Method

Select the HTTP method you want to use:

GET	To retrieve information for an entry
GET	To create a new entry
PUT	To update/replace an existing entry
PATCH	To make a partial entry update
DELETE	To delete an entry

Headers

Enter the desired request headers. You don't have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example

List the boards you are a member of and include all of the list fields in the response API call:

Step by step guide

1. Insert the Trello > Make an API call module in your scenario.

2. Find the API endpoint you would like to call in the Trello API documentation - e.g. Get emoji.

3. Configure the module's configuration to call the Get emoji endpoint:

   URL	emoji
   Method	GET

4. 

   Execute the scenario.

5. Click the bubble above the module to verify the module's output:

   

Searches

Get Custom Field Options

Retrieves the custom field options for the list (drop-down menu) type.

Custom Field ID	Enter the Custom Field ID you want to retrieve from the options.

Search for Members

Retrieves information about Trello members.

Query	Enter the full name or username of the user you want to search.
* Partial *	By default, this module searches for each word in your query against exactly matching words within member content. Enabling the Partial option means that we will look for content that starts with any of the words in your query. If you are looking for a card titled "My Development Status Report", by default you would need to search for "Development". If you have partially enabled, you will be able to search for "dev" but not "velopment".
Maximum number of returned members	The maximum number of members Ibexa Connect will return during one execution cycle.

Search for Boards

Retrieves information about a selected board.

Query	Enter the name (or a part of the name) of the board you want to get information about.
Maximum number of returned boards	The maximum number of boards Ibexa Connect will return during one execution cycle. Must be lower than or equal to 1000.
* Partial *	By default, this module searches for each word in your query against exactly matching words within member content. Enabling the Partial option means that we will look for content that starts with any of the words in your query. If you are looking for a card titled "My Development Status Report", by default you would need to search for "Development". If you have partially enabled, you will be able to search for "dev" but not "velopment".
Boards	Enter 'mine' or comma-separated list of board IDs.

Search for Organizations

Retrieves information about a selected team.

Query	Enter the name (or a part of the name) of the team you want to get information about.
Maximum number of returned members	The maximum number of teams Ibexa Connect will return during one execution cycle. Must be lower than or equal to 1000.
* Partial *	By default, this module searches for each word in your query against exactly matching words within member content. Enabling the Partial option means that we will look for content that starts with any of the words in your query. If you are looking for a card titled "My Development Status Report", by default you would need to search for "Development". If you have partial enabled, you will be able to search for "dev" but not "velopment".
Organizations	Enter the organization IDs you want to look for.

List Comments in a Card

Enter a Card ID	Enter (map or select) the ID of the card that contains the comments you want to retrieve.
Maximum number of returned comments	The maximum number of comments Ibexa Connect will return during one execution cycle.
Since	Set the start date of the period in which the comment was created. Supported date and time formats. Example: 06/20/2019 5:27 PM
Before	Set the end date of the period in which the comment was created. Supported date and time formats. Example: 06/20/2019 5:27 PM

Get Board Lists

Board ID	Select the board you want to retrieve lists from.
Maximum number of returned lists	The maximum number of lists Ibexa Connect will return during one execution cycle. Must be lower than or equal to 1000.
Filter	Select whether all, closed, or open lists will be returned.

Retrieve Labels

Retrieves labels from a selected board.

Board ID	Select the board you want to retrieve labels from.
Limit	The maximum number of labels Ibexa Connect Ibexa Connect will return during one execution cycle. Must be lower than or equal to 1000.

Search for Cards

Board	Select the boards you want to search through. If no board is selected, all boards will be searched.
Query	Enter the search query. You can refine your search using the following search operators: Query Description -operator You can add “-” to any operator to do a negative search, such as -has:members to search for cards without any members assigned. @name Returns cards assigned to a member. member: also works. @me will include only your cards. #label Returns labeled cards. label:also works. For example, label:"FIX IT" will return cards with the label named “FIX IT”. board:id Returns cards within a specific board. For example, board:Trello will return cards on boards with Trello in the board name. list:name Returns cards within the list named “name”. has:attachments Returns cards with attachments. has:description, has:cover, has:members, and has:stickers also work as you would expect. due:day Returns cards due within 24 hours. due:week, due:month, and due:overdue also work as expected. You can search for a specific day range. For example, adding due:14 to search will include cards due in the next 14 days. created:day Returns cards created in the last 24 hours. created:week and created:month also work as expected. You can search for a specific day range. For example, adding created:14 to the search will include cards created in the last 14 days. edited:day Returns cards edited in the last 24 hours. edited:week and edited:month also work as expected. You can search for a specific day range. For example, adding edited:21 to the search will include cards edited in the last 21 days. description:, checklist:, comment:, and name: Returns cards matching the text of card descriptions, checklists, comments, or names. For example, comment: "FIX IT" will return cards with “FIX IT” in a comment. is:open and is:archived Returns cards that are open or archived. If neither is specified, Trello will return both types. is:starred Only includes cards on starred boards.
Maximum number of returned cards	The maximum number of cards Ibexa Connect will return during one execution cycle. Must be lower than or equal to 1000.
Partial	By default, this module searches for each word in your query against exactly matching words within member content. Enabling the Partial option means that we will look for content that starts with any of the words in your query. If you are looking for a card titled "My Development Status Report", by default you would need to search for "Development". If you have partial enabled, you will be able to search for "dev" but not "velopment".
Cards	Add the cards you want to search for.

Q & A

How to find the ID or the shortlink of a card in Trello

If you want to edit a card or create a new comment, you need to know the ID of the card or its shortlink. You can get this information from the output of the New Card trigger. The shortlink for a card can also be obtained by opening the card and clicking on the Share button. The shortlink can be found in the Link to this card box, at the end of the URL after https://trello.com/c/.

How to find other IDs

Board, list and comment IDs can only be obtained using triggers. The trello.com website does not show these IDs.