Trello
Trello is a project management tool that uses boards, lists and cards to help users organize tasks and collaborate with teams.
Categories: Productivity and Collaboration
Type: trello/v1
Connections
Version: 1
custom
Properties
| Name | Label | Type | Description | Required |
|---|---|---|---|---|
| key | Key | STRING | true | |
| token | Token | STRING | true |
Connection Setup
Create Trello App
- Navigate to https://trello.com/power-ups/admin.
- Click on New.
- Fill out form.
- Enter URL depending on your instance:
https://app.bytechef.io/callback(Cloud)http://localhost:5173/callback(Local dev)
- Click on Create.
- Click on API key.
- Click on Generate a new API key.
- Your API Key.
- Click on Token.
- Click Allow.
- Now you can copy your Token.
- Done 🚀.
Actions
Create Board
Name: createBoard
Creates a new board.
Properties
| Name | Label | Type | Description | Required |
|---|---|---|---|---|
| name | Name | STRING | The new name for the board. | true |
| desc | Description | STRING | A new description for the board. | false |
Example JSON Structure
{
"label" : "Create Board",
"name" : "createBoard",
"parameters" : {
"name" : "",
"desc" : ""
},
"type" : "trello/v1/createBoard"
}Output
This action does not produce any output.
Create Card
Name: createCard
Creates a new card.
Properties
| Name | Label | Type | Description | Required |
|---|---|---|---|---|
| idBoard | Board ID | STRING | ID of the board. | false |
| idList | List ID | STRING Depends OnidBoard | ID of the list where the card should be created in. | true |
| name | Name | STRING | The name for the card. | false |
| desc | Description | STRING | The description for the card. | false |
Example JSON Structure
{
"label" : "Create Card",
"name" : "createCard",
"parameters" : {
"idBoard" : "",
"idList" : "",
"name" : "",
"desc" : ""
},
"type" : "trello/v1/createCard"
}Output
Type: OBJECT
Properties
| Name | Type | Description |
|---|---|---|
| id | STRING | ID of the card. |
| desc | STRING | Description of the card. |
| idBoard | STRING | ID of the board the card belongs to. |
| idList | STRING | ID of the list the card belongs to. |
| name | STRING | Name of the card. |
Output Example
{
"id" : "",
"desc" : "",
"idBoard" : "",
"idList" : "",
"name" : ""
}Find Board ID
To find the Board ID, click here.
Find List ID
To find the List ID, click here.
Get Card
Name: getCard
Gets a card details.
Properties
| Name | Label | Type | Description | Required |
|---|---|---|---|---|
| idBoard | Board ID | STRING | ID of the board where card is located. | false |
| id | Card ID | STRING Depends OnidBoard | true |
Example JSON Structure
{
"label" : "Get Card",
"name" : "getCard",
"parameters" : {
"idBoard" : "",
"id" : ""
},
"type" : "trello/v1/getCard"
}Output
Type: OBJECT
Properties
| Name | Type | Description |
|---|---|---|
| id | STRING | ID of the card. |
| desc | STRING | Description of the card. |
| idBoard | STRING | ID of the board the card belongs to. |
| idList | STRING | ID of the list the card belongs to. |
| name | STRING | Name of the card. |
Output Example
{
"id" : "",
"desc" : "",
"idBoard" : "",
"idList" : "",
"name" : ""
}Find Board ID
To find the Board ID, click here.
Find Card ID
To find the Card ID, click here.
Triggers
New Card
Name: newCard
Triggers when a new card is created on specified board or list.
Type: DYNAMIC_WEBHOOK
Properties
| Name | Label | Type | Description | Required |
|---|---|---|---|---|
| idBoard | Board ID | STRING | false | |
| idList | List ID | STRING Depends OnidBoard | false |
Output
Type: OBJECT
Properties
| Name | Type | Description |
|---|---|---|
| id | STRING | ID of the card. |
| desc | STRING | Description of the card. |
| idBoard | STRING | ID of the board the card belongs to. |
| idList | STRING | ID of the list the card belongs to. |
| name | STRING | Name of the card. |
JSON Example
{
"label" : "New Card",
"name" : "newCard",
"parameters" : {
"idBoard" : "",
"idList" : ""
},
"type" : "trello/v1/newCard"
}Find Board ID
To find the Board ID, click here.
Find List ID
To find the List ID, click here.
What to do if your action is not listed here?
If this component doesn't have the action you need, you can use Custom Action to create your own. Custom Actions empower you to define HTTP requests tailored to your specific requirements, allowing for greater flexibility in integrating with external services or APIs.
To create a Custom Action, simply specify the desired HTTP method, path, and any necessary parameters. This way, you can extend the functionality of your component beyond the predefined actions, ensuring that you can meet all your integration needs effectively.
Additional Instructions
How to find Board ID
- Method 1: Via API
Use the GET /members/AUTHORIZED_USER_ID/boards endpoint to retrieve a list of all boards and their IDs.
- Method 2: Via UI
Open the Trello board on your browser and add .json to the end of URL so that you have something like https://trello.com/b/123/my-trello-board.json. The board ID is first value in that json listed under key id.
The Board ID can also be found in the output of the following actions and triggers:
- Create Card
- Get Card
- New Card trigger
How to find List ID
- Method 1: Via API
Use the GET /boards/BOARD_ID/lists endpoint to retrieve a list of all lists and their IDs.
- Method 2: Via UI
Open the Trello board on your browser and add .json to the end of URL so that you have something like https://trello.com/b/123/my-trello-board.json. Search for the name of your list and above the name should be a field with key id and value is your list ID.
The List ID can also be found in the output of the following actions and triggers:
- Create Card
- Get Card
- New Card trigger
How to find Card ID
- Method 1: Via API
Use the GET /boards/BOARD_ID/cards endpoint to retrieve a list of all cards and their IDs.
- Method 2: Via UI
Open the Trello board on your browser where your card is located. Open the card you want and you can find card ID in the URL. For example in https://trello.com/c/123/my-trello-card, card ID is 123.
The Card ID can also be found in the output of the following actions and triggers:
- Create Card
- Get Card
- New Card trigger
How is this guide?
Last updated on