Trello

Kanban boards: list boards, lists and cards; create, move and comment on cards.

8 actions API key 5 read3 write Calls api.trello.com

Connect

TypeScript

const conn = await setu.connections.initiate({ userId: "user_1", toolkit: "trello" });
console.log(conn.connectUrl); // show this to your user
await conn.waitUntilActive();

Permissions requested

This toolkit uses a single credential and requests no scopes.

Actions

Add comment to cardwritetrello.add_commentAdd a comment to a card.

Input	Type		Description
`card_id`	string	Required	Card id
`text`	string	Required	Comment text

TypeScript

await setu.execute({
  userId: "user_1",
  action: "trello.add_comment",
  input: {
    "card_id": "<card_id>",
    "text": "<text>"
  },
});

Create cardwritetrello.create_cardCreate a card in a list.

Input	Type		Description
`list_id`	string	Required	Id of the list to add the card to
`name`	string	Optional	Card title
`desc`	string	Optional	Card description
`due`	string	Optional	Due date, ISO 8601
`pos`	string	Optional	Position: top, bottom or a number

TypeScript

await setu.execute({
  userId: "user_1",
  action: "trello.create_card",
  input: {
    "list_id": "<list_id>"
  },
});

Get boardreadtrello.get_boardGet one Trello board by id, with its name, description and url.

Input	Type		Description
`board_id`	string	Required	Board id

TypeScript

await setu.execute({
  userId: "user_1",
  action: "trello.get_board",
  input: {
    "board_id": "<board_id>"
  },
});

Get cardreadtrello.get_cardGet one Trello card by id, with its list, due date and description.

Input	Type		Description
`card_id`	string	Required	Card id

TypeScript

await setu.execute({
  userId: "user_1",
  action: "trello.get_card",
  input: {
    "card_id": "<card_id>"
  },
});

List board cardsreadtrello.list_board_cardsList the cards on a board, with their list ids.

Input	Type		Description
`board_id`	string	Required	Board id

TypeScript

await setu.execute({
  userId: "user_1",
  action: "trello.list_board_cards",
  input: {
    "board_id": "<board_id>"
  },
});

List board listsreadtrello.list_board_listsList the lists (columns) of a board.

Input	Type		Description
`board_id`	string	Required	Board id
`filter`	string	Optional	Which lists

TypeScript

await setu.execute({
  userId: "user_1",
  action: "trello.list_board_lists",
  input: {
    "board_id": "<board_id>"
  },
});

List my boardsreadtrello.list_my_boardsList the boards the authorized Trello user belongs to.

Input	Type		Description
`filter`	string	Optional	Which boards
`fields`	string	Optional	Comma-separated board fields, e.g. name,url

TypeScript

await setu.execute({
  userId: "user_1",
  action: "trello.list_my_boards",
  input: {},
});

Move card to listwritetrello.move_cardMove a card to another list (and optionally change its position).

Input	Type		Description
`card_id`	string	Required	Card id
`list_id`	string	Required	Id of the destination list
`pos`	string	Optional	Position: top, bottom or a number

TypeScript

await setu.execute({
  userId: "user_1",
  action: "trello.move_card",
  input: {
    "card_id": "<card_id>",
    "list_id": "<list_id>"
  },
});