ByteChef LogoByteChef

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

NameLabelTypeDescriptionRequired
keyKeySTRINGtrue
tokenTokenSTRINGtrue

Connection Setup

Create Trello App

  1. Navigate to https://trello.com/power-ups/admin.
  2. Click on New.
  3. Fill out form.
  4. Enter URL depending on your instance:
    • https://app.bytechef.io/callback (Cloud)
    • http://localhost:5173/callback (Local dev)
  5. Click on Create.
  6. Click on API key.
  7. Click on Generate a new API key.
  8. Your API Key.
  9. Click on Token.
  10. Click Allow.
  11. Now you can copy your Token.
  12. Done 🚀.

Actions

Create Board

Name: createBoard

Creates a new board.

Properties

NameLabelTypeDescriptionRequired
nameNameSTRINGThe new name for the board.true
descDescriptionSTRINGA 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

NameLabelTypeDescriptionRequired
idBoardBoard IDSTRINGID of the board.false
idListList IDSTRING
Depends On idBoard
ID of the list where the card should be created in.true
nameNameSTRINGThe name for the card.false
descDescriptionSTRINGThe 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

NameTypeDescription
idSTRINGID of the card.
descSTRINGDescription of the card.
idBoardSTRINGID of the board the card belongs to.
idListSTRINGID of the list the card belongs to.
nameSTRINGName 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

NameLabelTypeDescriptionRequired
idBoardBoard IDSTRINGID of the board where card is located.false
idCard IDSTRING
Depends On idBoard
true

Example JSON Structure

{
  "label" : "Get Card",
  "name" : "getCard",
  "parameters" : {
    "idBoard" : "",
    "id" : ""
  },
  "type" : "trello/v1/getCard"
}

Output

Type: OBJECT

Properties

NameTypeDescription
idSTRINGID of the card.
descSTRINGDescription of the card.
idBoardSTRINGID of the board the card belongs to.
idListSTRINGID of the list the card belongs to.
nameSTRINGName 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

NameLabelTypeDescriptionRequired
idBoardBoard IDSTRINGfalse
idListList IDSTRING
Depends On idBoard
false

Output

Type: OBJECT

Properties

NameTypeDescription
idSTRINGID of the card.
descSTRINGDescription of the card.
idBoardSTRINGID of the board the card belongs to.
idListSTRINGID of the list the card belongs to.
nameSTRINGName 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

On this page