Trello

Learn how to use Trello with Composio

Overview

SLUG

TRELLO

Description

A web-based, kanban-style, list-making application.

Authentication Details

consumer_key
stringRequired
consumer_secret
stringRequired
scopes
stringDefaults to read,write,account
bearer_token
string
token
stringRequired

Tools

SLUG: TRELLO_ADD_BOARDS

Creates a new trello board; the 'name' parameter is required for creation, and various preferences can be customized or cloned from a source board.

Action Parameters

closed
string
desc
string
idBoardSource
string
idOrganization
string
keepFromSource
string
labelNames__blue
string
labelNames__green
string
labelNames__orange
string
labelNames__purple
string
labelNames__red
string
labelNames__yellow
string
name
string
powerUps
string
prefs__background
string
prefs__calendarFeedEnabled
string
prefs__cardAging
string
prefs__cardCovers
string
prefs__comments
string
prefs__invitations
string
prefs__permissionLevel
string
prefs__selfJoin
string
prefs__voting
string
prefs_background
string
prefs_cardAging
string
prefs_cardCovers
string
prefs_comments
string
prefs_invitations
string
prefs_permissionLevel
string
prefs_selfJoin
string
prefs_voting
string
subscribed
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: TRELLO_ADD_CARDS

Creates a new card in a trello list; `idlist` is required, and if `idcardsource` is used, the source card must be accessible.

Action Parameters

closed
string
desc
string
due
string
fileSource
string
idAttachmentCover
string
idBoard
string
idCardSource
string
idLabels
string
idList
string
idMembers
string
keepFromSource
string
labels
string
name
string
pos
string
subscribed
string
urlSource
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: TRELLO_ADD_LISTS

Creates a new list on a specified trello board, with options to copy an existing list, set its position, initial state (archived/subscribed), and does not modify existing lists or move cards.

Action Parameters

closed
string
idBoard
string
idListSource
string
name
string
pos
string
subscribed
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: TRELLO_DELETE_CARDS_BY_ID_CARD

Permanently deletes an archived trello card specified by its `idcard`.

Action Parameters

idCard
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: TRELLO_GET_BOARDS_BY_ID_BOARD

Fetches comprehensive details for a specific trello board by its id; this is a read-only action.

Action Parameters

action_fields
stringDefaults to all
action_member
string
action_memberCreator
string
action_memberCreator_fields
stringDefaults to avatarHash, fullName, initials and username
action_member_fields
stringDefaults to avatarHash, fullName, initials and username
actions
string
actions_display
string
actions_entities
string
actions_format
stringDefaults to list
actions_limit
stringDefaults to 50
actions_since
string
boardStars
stringDefaults to none
card_attachment_fields
stringDefaults to all
card_attachments
string
card_checklists
stringDefaults to none
card_fields
stringDefaults to all
card_stickers
string
cards
stringDefaults to none
checklist_fields
stringDefaults to all
checklists
stringDefaults to none
fields
stringDefaults to name, desc, descData, closed, idOrganization, pinned, url, shortUrl, prefs and labelNames
idBoard
stringRequired
label_fields
stringDefaults to all
labels
stringDefaults to none
labels_limit
stringDefaults to 50
list_fields
stringDefaults to all
lists
stringDefaults to none
member_fields
stringDefaults to avatarHash, initials, fullName, username and confirmed
members
stringDefaults to none
membersInvited
stringDefaults to none
membersInvited_fields
stringDefaults to avatarHash, initials, fullName and username
memberships
stringDefaults to none
memberships_member
string
memberships_member_fields
stringDefaults to fullName and username
myPrefs
string
organization
string
organization_fields
stringDefaults to name and displayName
organization_memberships
stringDefaults to none

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: TRELLO_GET_BOARDS_CARDS_BY_ID_BOARD

Retrieves cards from an existing trello board, allowing filtering and customization of fields for cards, attachments, and members.

Action Parameters

actions
string
attachment_fields
stringDefaults to all
attachments
string
before
string
checkItemStates
string
checklists
stringDefaults to none
fields
stringDefaults to all
filter
stringDefaults to visible
idBoard
stringRequired
limit
string
member_fields
stringDefaults to avatarHash, fullName, initials and username
members
string
since
string
stickers
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: TRELLO_GET_LISTS_BOARD_BY_ID_LIST

Retrieves the board to which a specific trello list belongs.

Action Parameters

fields
stringDefaults to all
idList
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: TRELLO_GET_MEMBERS_BY_ID_MEMBER

Fetches comprehensive information about a trello member, specified by id or username, including profile, activities, boards, cards, notifications, and organization affiliations, with customizable detail levels via filters and field parameters.

Action Parameters

action_before
string
action_fields
stringDefaults to all
action_since
string
actions
string
actions_display
string
actions_entities
string
actions_limit
stringDefaults to 5
boardBackgrounds
stringDefaults to none
boardStars
string
board_action_fields
stringDefaults to all
board_actions
string
board_actions_display
string
board_actions_entities
string
board_actions_format
stringDefaults to list
board_actions_limit
stringDefaults to 50
board_actions_since
string
board_fields
stringDefaults to name, closed, idOrganization and pinned
board_lists
stringDefaults to open
board_memberships
stringDefaults to none
board_organization
string
board_organization_fields
stringDefaults to name and displayName
boards
string
boardsInvited
string
boardsInvited_fields
stringDefaults to name, closed, idOrganization and pinned
card_attachment_fields
stringDefaults to url and previews
card_attachments
string
card_fields
stringDefaults to all
card_member_fields
stringDefaults to avatarHash, fullName, initials and username
card_members
string
card_stickers
string
cards
stringDefaults to none
customBoardBackgrounds
stringDefaults to none
customEmoji
stringDefaults to none
customStickers
stringDefaults to none
fields
stringDefaults to all
idMember
stringRequired
notification_before
string
notification_fields
stringDefaults to all
notification_memberCreator
string
notification_memberCreator_fields
stringDefaults to avatarHash, fullName, initials and username
notification_since
string
notifications
string
notifications_display
string
notifications_entities
string
notifications_limit
stringDefaults to 50
organization_fields
stringDefaults to all
organization_paid_account
string
organizations
stringDefaults to none
organizationsInvited
stringDefaults to none
organizationsInvited_fields
stringDefaults to all
paid_account
string
savedSearches
string
tokens
stringDefaults to none

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: TRELLO_ACTION_GET_BOARD_BY_ID_ACTION

Deprecated: use `get actions board by id action` instead. retrieves details for the trello board associated with a specific action id, returning board information only.

Action Parameters

fields
stringDefaults to all
idAction
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: TRELLO_ACTION_GET_BY_ID

Deprecated: use `get actions by id action` instead. retrieves detailed information about a specific trello action by its id.

Action Parameters

display
string
entities
string
fields
stringDefaults to all
idAction
stringRequired
member
string
memberCreator
string
memberCreator_fields
stringDefaults to avatarHash, fullName, initials and username
member_fields
stringDefaults to avatarHash, fullName, initials and username

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: TRELLO_ACTION_GET_LIST_BY_ID_ACTION

Retrieves the trello list associated with a specific trello action id, for actions linked to a list. <<DEPRECATED use get_actions_list_by_id_action>>

Action Parameters

fields
stringDefaults to all
idAction
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: TRELLO_ADD_BOARDS_CALENDAR_KEY_GENERATE_BY_ID_BOARD

Generates a new calendar key for the trello board specified by `idboard`, invalidating any previous key for that board.

Action Parameters

idBoard
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: TRELLO_ADD_BOARDS_CHECKLISTS_BY_ID_BOARD

Creates a new, initially empty checklist with a given name on an existing and accessible trello board.

Action Parameters

idBoard
stringRequired
name
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: TRELLO_ADD_BOARDS_EMAIL_KEY_GENERATE_BY_ID_BOARD

Generates a new email key for the trello board specified by idboard to enable or reset adding cards via email; this invalidates any previously existing email key for the board.

Action Parameters

idBoard
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: TRELLO_ADD_BOARDS_LABELS_BY_ID_BOARD

Creates a new label on an existing trello board.

Action Parameters

color
string
idBoard
stringRequired
name
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: TRELLO_ADD_BOARDS_LISTS_BY_ID_BOARD

Creates a new, empty list on a specified, existing trello board, typically used as a column or category for organizing cards.

Action Parameters

idBoard
stringRequired
name
stringRequired
pos
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: TRELLO_ADD_BOARDS_MARK_AS_VIEWED_BY_ID_BOARD

Marks the trello board specified by idboard as viewed for the current user, exclusively updating its viewed status and potentially influencing its position in user-specific lists and notification settings.

Action Parameters

idBoard
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: TRELLO_ADD_BOARDS_POWER_UPS_BY_ID_BOARD

Enables the power-up specified by the 'value' parameter on the board; processes one power-up enablement per call.

Action Parameters

idBoard
stringRequired
value
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: TRELLO_ADD_CARDS_ACTIONS_COMMENTS_BY_ID_CARD

Adds a new text comment, which can include @mentions, to a trello card specified by its id; file attachments are not supported via this action.

Action Parameters

idCard
stringRequired
text
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: TRELLO_ADD_CARDS_ATTACHMENTS_BY_ID_CARD

Adds an attachment to a trello card by `idcard`; specify either a `file` to upload or a `url` to link, but not both.

Action Parameters

file
string
idCard
stringRequired
mimeType
string
name
string
url
string

Action Response

data
objectRequired
error
string
successful
booleanRequired