Trello

Reference

Trello gives you perspective over all your projects, at work and at home. It is an easy, free, flexible, and visual way to manage your projects and organize anything. Connect to Trello to manage your boards, lists and cards.

This connector is available in the following products and regions:

Service	Class	Regions
Logic Apps	Standard	All Logic Apps regions except the following: - Azure China regions - US Department of Defense (DoD)
Power Automate	Standard	All Power Automate regions except the following: - China Cloud operated by 21Vianet
Power Apps	Standard	All Power Apps regions except the following: - China Cloud operated by 21Vianet

Contact
Name	Microsoft
URL	Microsoft LogicApps Support Microsoft Power Automate Support Microsoft Power Apps Support

Connector Metadata
Publisher	Microsoft
Website	https://trello.com/
Privacy policy	https://www.atlassian.com/legal/privacy-policy

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	100	10 seconds

Actions

A simple version of list lists	A simple version of list lists to be used by dynamic values.
A simple version of the list boards	A simple version of the list boards API call with no parameters to be used by dynamic values.
A simple version of the list cards	A simple version of the list cards API method used by dynamic values.
Add a comment to a card	Add a comment to a specific card.
Add member to a card	Add a member to a specific card.
Close a board	Set a specific board to closed.
Create a board	Create a new board with the specified fields.
Create a card	Creates a new card with the parameters provided.
Create a card [DEPRECATED]	This action has been deprecated. Please use Create a card instead. ~~Creates a new card with the parameters provided.~~
Create a list	Create a new list.
Delete a card	Delete an existing card from the account.
Get a board by Id	Get a specific board by its unique identifier.
Get a card by id	Get a specific card by its unique id.
Get list by Id	Get an existing list and the cards in the list by the unique identifier of the list.
Get the team for a board	Get the team details for a specific board.
Get your User Profile info	Get information about your User Profile
List boards	List the boards matching the specified query parameters.
List comments for a card	List the comments for a specific card.
List labels of a board	List the labels of a specific board.
List members for a card	List the members for a specific card.
List members of a board	List the members of a specific board.
List members of a team	List the members in a specific team.
List teams you are a member of	The list of teams or organizations the account is a member of.
List the card lists in a board	List the card lists and the cards within the list in a specific board.
List the cards in a board	List the cards matching the query parameters in a specific board.
Update a board	Update an existing board.
Update a card	Update an existing card with new parameters.
Update a card [DEPRECATED]	This action has been deprecated. Please use Update a card instead. ~~Update an existing card with new parameters.~~
Update a list	Update an existing list.

A simple version of list lists

Operation ID:: ListListsSimple

A simple version of list lists to be used by dynamic values.

Parameters

Name	Key	Required	Type	Description
Board Id	board_id	True	string	Unique Id of the board to fetch lists.

Returns

response: array of List

A simple version of the list boards

Operation ID:: ListBoardsSimple

A simple version of the list boards API call with no parameters to be used by dynamic values.

Returns

response: array of Board

A simple version of the list cards

Operation ID:: ListCardsSimple

A simple version of the list cards API method used by dynamic values.

Parameters

Name	Key	Required	Type	Description
Board Id	board_id	True	string	Board Id.

Returns

response: array of Card

Add a comment to a card

Operation ID:: AddCommentToCard

Add a comment to a specific card.

Parameters

Name	Key	Required	Type	Description
Board Id	board_id	True	string	The unique id of the board to add a comment to.
Card Id	card_id	True	string	The unique id of the card.
Comment Text	text		string	The text of the comment.

Returns

The model for getting a comment

Body: Comment

Add member to a card

Operation ID:: AddMemberToCard

Add a member to a specific card.

Parameters

Name	Key	Required	Type	Description
Board Id	board_id	True	string	The unique id of the board the card is on.
Card Id	cardId	True	string	The unique identifier of the card to add a member to.
Member Id or Username	memberId	True	string	The member id or username to add to the card.

Returns

response: array of Member

Close a board

Operation ID:: CloseBoard

Set a specific board to closed.

Parameters

Name	Key	Required	Type	Description
Board Id	board_id	True	string	The unique id of the board to close.

Returns

A Trello Board Object

Body: Board

Create a board

Operation ID:: CreateBoard

Create a new board with the specified fields.

Parameters

Name	Key	Required	Type	Description
Board Name	name	True	string	The name of the board.
Create Default Lists	defaultLists		string	A string (true, false) determining whether or not to create default lists.
Board Description	desc		string	The description of the board.
Team Id	idOrganization		string	The id of the team.
Permission Level	prefs_permissionLevel		string	The permission level of the board. Valid options are 'org', 'private', or 'public'.
Comment Preferences	prefs_comments		string	The comment preferences of the board.
Invitation Preferences	prefs_invitations		string	The invitation preferences of the board.
Use Card Covers	prefs_cardCovers		string	A string (true, false) determining whether or not to use card covers.
Background Color	prefs_background		string	The background color of the board.
Voting Power-up Preferences	prefs_voting		string	The voting power-up preferences of the board.
Card Aging Power-up Preferences	prefs_cardAging		string	The card aging power-up preferences of the board.
Enable Calendar Power-up	enable_calendar		string	A string (true, false) determining whether or not to enable calendar power-up.

Returns

A Trello Board Object

Body: Board

Create a card

Operation ID:: CreateCard_V2

Creates a new card with the parameters provided.

Parameters

Name	Key	Required	Type	Description
Board Id	board_id	True	string	The id of the board to create the card in.
Parent List Id	idList	True	string	The id of the list that the card should be added to.
Card Name	name	True	string	The name of the new card.
Card Description	desc		string	The description of the new card.
Card Position	pos		string	The position of the card. Specify top, bottom, or a positive number. Note this is used in relation to existing card locations so the resulting location may not match the exact value provided.
Member Ids	idMembersArray		array of string	An array of member Ids to attach to the card.
Label Ids	idLabelsArray		array of string	An array of label Ids to attach to the card.
Source Url	urlSource		string	Source url of the card. Has to be a URL starting with http:// or https:// or null.
Source File	fileSource		string	Source file of the card.
Source Card Id	idCardSource		string	The Id of the card to copy into a new card.
Properties From Source Card	keepFromSource		string	Properties of the card to copy over from the source.
Due Date	due		string	The due date of the card.

Returns

A Trello Card Object

Body: Card

Create a card [DEPRECATED]

Operation ID:: CreateCard

This action has been deprecated. Please use Create a card instead.

~~Creates a new card with the parameters provided.~~

Parameters

Name	Key	Required	Type	Description
Board Id	board_id	True	string	The id of the board to create the card in.
Parent List Id	idList	True	string	The id of the list that the card should be added to.
Card Name	name	True	string	The name of the new card.
Card Description	desc		string	The description of the new card.
Card Position	pos		string	The position of the card. Specify top, bottom, or a positive number. Note this is used in relation to existing card locations so the resulting location may not match the exact value provided.
Member Id	idMembers		string	A comma seperated list of member Ids to attach to the card.
Label Id	idLabels		string	A comma-separated list of labels Ids to attach to the card.
Source Url	urlSource		string	Source url of the card. Has to be a URL starting with http:// or https:// or null.
Source File	fileSource		string	Source file of the card.
Source Card Id	idCardSource		string	The Id of the card to copy into a new card.
Properties From Source Card	keepFromSource		string	Properties of the card to copy over from the source.
Due Date	due		string	The due date of the card.

Returns

response: object

Create a list

Operation ID:: CreateList

Create a new list.

Parameters

Name	Key	Required	Type	Description
List Name	name	True	string	The name of the list.
Board Id	idBoard	True	string	The unique Id of the board to create the list in.
List Position	pos		string	The position of the list. Specify top, bottom, or a positive number.
List Source	idListSource		string	The id of the list to copy into the new list.

Returns

A Trello List Object

Body: CreateListResponse

Delete a card

Operation ID:: DeleteCard

Delete an existing card from the account.

Parameters

Name	Key	Required	Type	Description
Board Id	board_id	True	string	The id of the board to fetch cards from.
Card Id	card_id	True	string	The id of the card to delete.

Returns

response: object

Get a board by Id

Operation ID:: GetBoard

Get a specific board by its unique identifier.

Parameters

Name	Key	Required	Type	Description
Board Id	board_id	True	string	The unique Id of the board to get.
Actions	actions		string	List the actions to return. Specify 'all' or a comma seperated list of valid values.
Action Entities	action_entities		boolean	A boolean value (true, false) determining whether or not to return action entities.
Actions Display	actions_display		boolean	A boolean value (true, false) determining whether or not to return actions display.
Actions Format	actions_format		string	Specify the format of the actions to return. Valid options are 'count', 'list', 'minimal'.
Actions Since	actions_since		date-time	Only return the actions after this date.
Actions Limit	actions_limit		integer	Max number of actions to return.
Action Field	action_fields		string	List the fields to return with each field. Specify 'all' or a comma seperated list of valid values.
Action Member	action_member		boolean	A boolean value (true, false) determining whether or not to return action members.
Action Member Fields	action_member_fields		string	List the member fields to return with each action member. Specify 'all' or a comma seperated list of valid values.
Action Member Creator	action_memberCreator		boolean	A boolean value (true, false) determining whether or not to return action member creator.
Action Member Creator Fields	action_memberCreator_fields		string	List the action member creator fields to return. Specify 'all' or a comma seperated list of valid values.
Cards	cards		string	Specify the cards to return. Valid options are 'all', 'closed', 'none', 'open', or 'visible'.
Card Fields	card_fields		string	List the fields to return for each card. Specify 'all' or a comma seperated list of valid values.
Card Attachments	card_attachments		boolean	A boolean value (true, false) determining whether or not to return attachments on cards.
Card Attachment Fields	card_attachment_fields		string	List the attachment fields to return for each attachment. Specify 'all' or a comma seperated list of valid values.
Card Checklists	card_checklists		string	Specify the checklists to return for each card.
Card Stickers	card_stickers		boolean	A boolean value (true, false) determining whether or not to return card stickers.
Board Stars	boardStars		string	Specify the board stars to return.
Labels	labels		string	Specify the labels to return.
Label Fields	label_fields		string	List the label fields to return for each label. Specify 'all' or a comma seperated list of valid values.
Label Limits	labels_limit		integer	Max number of labels to return.
Lists	lists		string	Specify the lists to return.
List Fields	list_fields		string	List the list fields to return for each list. Specify 'all' or a comma seperated list of valid values.
Memberships	memberships		string	List the memberships to return. Specify 'all' or a comma seperated list of valid values.
Memberships Member	memberships_member		boolean	A boolean value (true, false) determining whether or not to return membership members.
Memberships Member Fields	memberships_member_fields		string	List the member fields to return for each membership member. Specify 'all' or a comma seperated list of valid values.
Members	members		string	List the members to return. Specify 'all' or a comma seperated list of valid values.
Member Fields	member_fields		string	List the member fields to return for each member. Specify 'all' or a comma seperated list of valid values.
Invited Members	membersInvited		string	Specify the invited members to return.
Invited Member Fields	membersInvited_fields		string	List the fields to return for each. Specify 'all' or a comma seperated list of valid values.
Checklists	checklists		string	Specify the checklists to return.
Checklist Fields	checklist_fields		string	List the checklist fields to return for each checklist. Specify 'all' or a comma seperated list of valid values.
Organization	organization		boolean	A boolean value (true, false) determining whether or not to return the organization information.
Organization Fields	organization_fields		string	List the organization fields to return for each organization. Specify 'all' or a comma seperated list of valid values.
Organization Memberships	organization_memberships		string	List the organization memberships to return. Specify 'all' or a comma seperated list of valid values.
My perfs	myPerfs		boolean	A boolean value (true, false) determining whether or not to return my perfs.
Fields	fields		string	List the fields to return. Specify 'all' or a comma seperated list of valid values.

Returns

A Trello Board Object

Body: BoardWithChecklists

Get a card by id

Operation ID:: GetCard

Get a specific card by its unique id.

Parameters

Name	Key	Required	Type	Description
Board Id	board_id	True	string	The id of the board to fetch cards in.
Card Id	card_id	True	string	The id of the card to fetch.
Actions	actions		string	List the actions to return. Specify 'all' or a comma seperated list of valid values.
Actions Entities	actions_entities		boolean	A boolean value (true, false) determining whether or not to return action entities.
Actions Display	actions_display		boolean	A boolean value (true, false) determining whether or not to return action displays.
Actions Limit	actions_limit		integer	Max number of actions to return.
Action Fields	action_fields		string	List of action fields to return for each action. Specify 'all' or a comma seperated list of valid values.
Member Creator Action Fields	action_memberCreator_fields		string	List of action member creator fields to return. Specify 'all' or a comma seperated list of valid values.
Attachments	attachments		boolean	A boolean value (true, false) determining whether or not to return attachments.
Attachments Fields	attachment_fields		string	List of attachment fields to return for each attachment. Specify 'all' or a comma seperated list of valid values.
Members	members		boolean	A boolean value (true, false) determining whether or not to return members.
Member Fields	member_fields		string	List of member fields to return for each member. Specify 'all' or a comma seperated list of valid values.
Voted Members	membersVoted		boolean	A boolean value (true, false) determining whether or not to return voted members.
Voted Member Fields	memberVoted_fields		string	List of voted member fields to return for each voted member. Specify 'all' or a comma seperated list of valid values.
Check Item States	checkItemStates		boolean	A boolean value (true, false) determining whether or not to return card states.
Item State Fields	checkItemState_fields		string	List of state fields to return for each of the card item state. Specify 'all' or a comma seperated list of valid values.
Checklists	checklists		string	Specify the checklists to return for each card.
Checklist Fields	checklist_fields		string	List of checklist fields to return for each checklist. Specify 'all' or a comma seperated list of valid values.
Board	board		boolean	A boolean value (true, false) determining whether or not to return the board which the card belongs to.
Board Fields	board_fields		string	List the board fields to return. Specify 'all' or a comma seperated list of valid values.
List	list		boolean	A boolean value (true, false) determining whether or not to return the list which the card belongs to.
List Fields	list_fields		string	List the list fields to return. Specify 'all' or a comma seperated list of valid values.
Stickers	stickers		boolean	A boolean value (true, false) determining whether or not to return the stickers.
Sticker Fields	sticker_fields		string	List the sticker fields to return for each sticker. Specify 'all' or a comma seperated list of valid values.
Fields	fields		string	List the card fields to return.

Returns

A Trello Card Object

Body: CardWithChecklists

Get list by Id

Operation ID:: GetList

Get an existing list and the cards in the list by the unique identifier of the list.

Parameters

Name	Key	Required	Type	Description
Board Id	board_id	True	string	The unique Id of the board to fetch the lists from.
List Id	list_id	True	string	The unique Id of the list to fetch.
Cards	cards		string	Specify the cards to return.
Card Fields	card_fields		string	List the card fields to return for each card. Specify 'all' or a comma seperated list of valid values.
Board	board		boolean	A boolean value (true, false) determining whether or not to return board information.
Board Fields	board_fields		string	List the board fields to return. Specify 'all' or a comma seperated list of valid values.
List Fields	fields		string	List the list fields to return. Specify 'all' or a comma seperated list of valid values.

Returns

A Trello List Object

Body: List

Get the team for a board

Operation ID:: GetTeamForBoard

Get the team details for a specific board.

Parameters

Name	Key	Required	Type	Description
Board Id	board_id	True	string	The unique Id of the board to fetch team.

Returns

A Trello Team

Body: Team

Get your User Profile info

Operation ID:: GetUserProfile

Get information about your User Profile

Parameters

Name	Key	Required	Type	Description
Fields	fields		string	List the fields to return. Specify 'all' or a comma seperated list of valid values.

Returns

response: object

List boards

Operation ID:: ListBoards

List the boards matching the specified query parameters.

Parameters

Name	Key	Type	Description
Filter	filter	string	List filters to apply to board results. Specify 'all' or a comma seperated list of valid values.
Fields	fields	string	List the board fields to return. Specify 'all' or a comma seperated list of valid values.
Actions	actions	string	List the action fields to return. Specify 'all' or a comma seperated list of valid values.
Action Entities	actions_entities	boolean	A boolean value (true, false) determining whether or not to return action entities.
Action Limit	actions_limit	integer	The max number of actions to return.
Actions Format	actions_format	string	Specify the format of the actions to return. The valid options are 'count', 'list', 'minimal'.
Actions Since	actions_since	date-time	Return actions after the specified date.
Action Fields	action_fields	string	List the fields of the action to return. Specify 'all' or a comma seperated list of valid values.
Memberships	memberships	string	Specify membership information to return.
Organization	organization	boolean	A boolean value (true, false) determining whether or not to return organization information.
Organization Fields	organization_fields	string	List the organization fields to return. Specify 'all' or a comma seperated list of valid values.
Lists	lists	string	Specify whether to return lists which belong to the board.

Returns

response: array of Board

List comments for a card

Operation ID:: ListCardComments

List the comments for a specific card.

Parameters

Name	Key	Required	Type	Description
Board Id	board_id	True	string	The unique id of the board to look for comments on.
Card Id	card_id	True	string	The unique id of the card.

Returns

response: array of Comment

List labels of a board

Operation ID:: ListBoardLabels

List the labels of a specific board.

Parameters

Name	Key	Required	Type	Description
Board Id	board_id	True	string	The unique Id of the board.

Returns

response: array of BoardLabel

List members for a card

Operation ID:: ListCardMembers

List the members for a specific card.

Parameters

Name	Key	Required	Type	Description
Board Id	board_id	True	string	The unique id of the board to look for cards on.
Card Id	card_id	True	string	The unique id of the card.

Returns

response: array of Member

List members of a board

Operation ID:: ListBoardMembers

List the members of a specific board.

Parameters

Name	Key	Required	Type	Description
Board Id	board_id	True	string	The unique Id of the board.

Returns

response: array of Member

List members of a team

Operation ID:: ListTeamMembers

List the members in a specific team.

Parameters

Name	Key	Required	Type	Description
Team Id	teamId	True	string	The unique Id of the team.

Returns

response: array of Member

List teams you are a member of

Operation ID:: ListTeams

The list of teams or organizations the account is a member of.

Returns

response: array of Team

List the card lists in a board

Operation ID:: ListLists

List the card lists and the cards within the list in a specific board.

Parameters

Name	Key	Required	Type	Description
Board Id	board_id	True	string	The unique id of the board to fetch lists.
Cards	cards		string	Specify the cards to return.
Card Fields	card_fields		string	List the card fields to return from. Specify 'all' or a comma seperated list of valid values.
Filter	filter		string	Specify the filter property for lists. Valid options are 'all, 'closed', 'none', or 'open'.
Fields	fields		string	List the fields to return. Specify 'all' or a comma seperated list of valid values.

Returns

response: array of List

List the cards in a board

Operation ID:: ListCards

List the cards matching the query parameters in a specific board.

Parameters

Name	Key	Required	Type	Description
Board Id	board_id	True	string	The unique id of the board.
Actions	actions		string	The list the actions to return. Specify 'all' or a comma seperated list of valid values.
Attachments	attachments		boolean	A boolean value (true, false) determining whether or not to show attachments.
Attachment Fields	attachment_fields		string	List the attachment fields to return. Specify 'all' or a comma seperated list of valid values.
Stickers	stickers		boolean	A boolean value (true, false) determining whether or not to show stickers.
Members	members		boolean	A boolean value (true, false) determining whether or not to show members.
Member Fields	memeber_fields		string	List the member fields to return. Specify 'all' or a comma seperated list of valid values.
Check Card States	checkItemStates		boolean	A boolean value (true, false) determining whether or not to return the card states.
Checklists	checklists		string	Specify the checklists to return.
Limit	limit		integer	The max number of results to return, between 1 and 1000.
Since	since		date-time	Fetch all cards after this date.
Before	before		date-time	Fetch all cards before this date.
Filter	filter		string	An option on how to filter the response. The allowed values are 'all', 'closed', 'none', 'open' or 'visible'.
Fields	fields		string	List the card fields to return. Specify 'all' or a comma seperated list of valid values.

Returns

response: array of Card

Update a board

Operation ID:: UpdateBoard

Update an existing board.

Parameters

Name	Key	Required	Type	Description
Board Id	board_id	True	string	The unique identifier of the board to update.
Board Name	name		string	The name of the board.
Create Default Lists	defaultLists		string	A string (true, false) determining whether or not to create default lists.
Board Description	desc		string	The description of the board.
Team Id	idOrganization		string	The id of the team.
Permission Level	prefs_permissionLevel		string	The permission level of the board.
Comment Preferences	prefs_comments		string	The comment preferences on the board. Valid options are 'disabled', 'members', 'observers', 'org' or 'public'.
Invitation Preferences	prefs_invitations		string	The invitation preferences of the board. Valid options are 'admins' or 'members'.
Use Card Covers	prefs_cardCovers		string	A string (true, false) determining whether or not to use card covers.
Background Color	prefs_background		string	The background color of the board.
Voting Power-up Preferences	prefs_voting		string	The voting power-up preferences of the board.
Card Aging Power-up Preferences	prefs_cardAging		string	The card aging power-up preferences of the board.
Enable Calendar Power-up	enable_calendar		string	A string (true, false) determining whether or not to enable calendar power-up

Returns

A Trello Board Object

Body: Board

Update a card

Operation ID:: UpdateCard_V2

Update an existing card with new parameters.

Parameters

Name	Key	Required	Type	Description
Board id	board_id	True	string	The id of the board to fetch cards from.
Card id	card_id	True	string	The id of the card to update.
Name	name	True	string	The updated name of the new card.
Description	desc		string	The updated description of the new card.
Is Closed	closed		boolean	A boolean value (true, false) determining whether or not the card is closed.
Member Ids	idMembersArray		array of string	An array of member Ids to attach to the card.
Cover attachment Ids	idAttachmentCover		string	The id of the attachment to attach to the card.
Board Id	idBoard		string	The id of the board to attach the card to.
List Id	idList		string	The id of the list to attach the card to.
Position	pos		string	The position of the card on the page. Specify top, bottom, or a positive number. Note this is used in relation to existing card locations so the resulting location may not match the exact value provided.
Due Date	due		string	The due date of the card.
Subscribed To Card	subscribed		boolean	A boolean value (true, false) determining whether or not to subscribe to the card.

Returns

A Trello Card Object

Body: Card

Update a card [DEPRECATED]

Operation ID:: UpdateCard

This action has been deprecated. Please use Update a card instead.

~~Update an existing card with new parameters.~~

Parameters

Name	Key	Required	Type	Description
Board id	board_id	True	string	The id of the board to fetch cards from.
Card id	card_id	True	string	The id of the card to update.
Name	name	True	string	The updated name of the new card.
Description	desc		string	The updated description of the new card.
Is Closed	closed		boolean	A boolean value (true, false) determining whether or not the card is closed.
Cover attachment Ids	idAttachmentCover		string	The id of the attachment to attach to the card.
Board Id	idBoard		string	The id of the board to attach the card to.
List Id	idList		string	The id of the list to attach the card to.
Position	pos		string	The position of the card on the page. Specify top, bottom, or a positive number. Note this is used in relation to existing card locations so the resulting location may not match the exact value provided.
Due Date	due		string	The due date of the card.
Subscribed To Card	subscribed		boolean	A boolean value (true, false) determining whether or not to subscribe to the card.

Returns

A Trello Card Object

Body: Card

Update a list

Operation ID:: UpdateList

Update an existing list.

Parameters

Name	Key	Required	Type	Description
Board Id	board_id	True	string	The unique id of the board the list is on.
List Id	list_id	True	string	The unique id of the list to update.
List Name	name		string	The new list name.
Closed	closed		string	A string (true, false) determining whether or not to close the list.
Board to move to	idBoard		string	The unique id of the board to move the list to.
List Position	pos		string	The list position (top, bottom, or number).
Subscribed	subscribed		string	A boolean value (true, false) determining whether or not to subscribe to the list.

Returns

A Trello List Object

Body: CreateListResponse

Triggers

When a new card is added to a board (V2)	Triggers a flow when a new card is added to a board.
When a new card is added to a board (V3) (Preview)	Triggers a flow when a new card is added to a board.
When a new card is added to a board [DEPRECATED]	This action has been deprecated. Please use When a new card is added to a board (V3) instead. ~~Triggers a flow when a new card is added to a board.~~
When a new card is added to a list (V2)	Triggers a flow when a new card is added to a list.
When a new card is added to a list (V3) (Preview)	Triggers a flow when a new card is added to a list.
When a new card is added to a list [DEPRECATED]	This action has been deprecated. Please use When a new card is added to a list (V3) instead. ~~Triggers a flow when a new card is added to a list.~~

When a new card is added to a board (V2)

Operation ID:: OnNewCardInBoardV2

Triggers a flow when a new card is added to a board.

Parameters

Name	Key	Required	Type	Description
Board Id	board_id	True	string	The unique id of the board.

Returns

A Trello Card Object

Body: CardInAction

When a new card is added to a board (V3) (Preview)

Operation ID:: OnNewCardInBoardV3

Triggers a flow when a new card is added to a board.

Parameters

Name	Key	Required	Type	Description
Board Id	board_id	True	string	The unique board id.

Returns

A Trello Card Object

Body: CardInAction

When a new card is added to a board [DEPRECATED]

Operation ID:: OnNewCardInBoard

This action has been deprecated. Please use When a new card is added to a board (V3) instead.

~~Triggers a flow when a new card is added to a board.~~

Parameters

Name	Key	Required	Type	Description
Board Id	board_id	True	string	The unique id of the board.

Returns

A Trello Card Object

Body: Card

When a new card is added to a list (V2)

Operation ID:: OnNewCardInListV2

Triggers a flow when a new card is added to a list.

Parameters

Name	Key	Required	Type	Description
Board Id	board_id	True	string	The unique id of the board.
List Id	list_id	True	string	The unique id of the list in the specified board.

Returns

A Trello Card Object

Body: CardInAction

When a new card is added to a list (V3) (Preview)

Operation ID:: OnNewCardInListV3

Triggers a flow when a new card is added to a list.

Parameters

Name	Key	Required	Type	Description
Board Id	board_id	True	string	The unique id of the board.
List Id	list_id	True	string	The unique id of the list in the specified board.

Returns

A Trello Card Object

Body: CardInAction

When a new card is added to a list [DEPRECATED]

Operation ID:: OnNewCardInList

This action has been deprecated. Please use When a new card is added to a list (V3) instead.

~~Triggers a flow when a new card is added to a list.~~

Parameters

Name	Key	Required	Type	Description
Board Id	board_id	True	string	The unique id of the board.
List Id	list_id	True	string	The unique id of the list in the specified board.

Returns

A Trello Card Object

Body: Card

Definitions

Card

A Trello Card Object

Name	Path	Type	Description
Card Id	id	string	The unique id of the card.
Check Item States	checkItemStates	array of CheckItemState	The check item states in the card.
Card closed	closed	boolean	A boolean value (true, false) determining whether or not the card is closed.
Last Activity Date	dateLastActivity	date-time	The datetime of last activity on the card.
Card Description	desc	string	The description of the card.
Board Id	idBoard	string	The unique Id of the board which the card belongs to.
List Id	idList	string	The unique Id of the list which the card belongs to.
Voted Member Ids	idMembersVoted	array of string	The unique Ids of the voting members.
Card Short Id	idShort	integer	The short Id of the card.
Attachment Cover Id	idAttachmentCover	string	The unique Id of the attachment cover.
Is Manual Cover Attachment	manualCoverAttachment	boolean	A boolean value (true, false) determining whether or not the card has a manual cover attachment.
Label Ids	idLabels	array of string	A list of label Ids on the card.
Card Name	name	string	The name of the card.
Card Position	pos	double	The position of the card.
Card Short Link	shortLink	string	A short link to the card.
badges	badges	Badges	A Trello Badges Object
Card Due Date	due	date-time	The due date of the card.
Card Short Url	shortUrl	string	The short url link to the card.
Is Subscribed	subscribed	boolean	A boolean value (true, false) determining whether or not the card is subscribed to.
Card Full Url	url	string	The full url to the card.
Checklists	checklists	array of Checklist	The set of board checklists.

CardWithChecklists

A Trello Card Object

Name	Path	Type	Description
Card Id	id	string	The unique id of the card.
Check Item States	checkItemStates	array of CheckItemState	The check item states in the card.
Card closed	closed	boolean	A boolean value (true, false) determining whether or not the card is closed.
Last Activity Date	dateLastActivity	date-time	The datetime of last activity on the card.
Card Description	desc	string	The description of the card.
Board Id	idBoard	string	The unique Id of the board which the card belongs to.
List Id	idList	string	The unique Id of the list which the card belongs to.
Voted Member Ids	idMembersVoted	array of string	The unique Ids of the voting members.
Card Short Id	idShort	integer	The short Id of the card.
Attachment Cover Id	idAttachmentCover	string	The unique Id of the attachment cover.
Is Manual Cover Attachment	manualCoverAttachment	boolean	A boolean value (true, false) determining whether or not the card has a manual cover attachment.
Label Ids	idLabels	array of string	A list of label Ids on the card.
Card Name	name	string	The name of the card.
Card Position	pos	double	The position of the card.
Card Short Link	shortLink	string	A short link to the card.
badges	badges	Badges	A Trello Badges Object
Card Due Date	due	date-time	The due date of the card.
Card Short Url	shortUrl	string	The short url link to the card.
Is Subscribed	subscribed	boolean	A boolean value (true, false) determining whether or not the card is subscribed to.
Card Full Url	url	string	The full url to the card.
Checklists	checklists	array of Checklist	The set of card checklists.

CardInAction

A Trello Card Object

Name	Path	Type	Description
Card Id	id	string	The unique id of the card.
Card Short Id	idShort	integer	The short Id of the card.
Card Name	name	string	The name of the card.
Card Short Link	shortLink	string	A short link to the card.
Card Due Date	due	date-time	The due date of the card.

CheckItemState

A Trello Item State Object

Name	Path	Type	Description
Check item Id	idCheckItem	string	ID of the check item.
Check item State	state	string	State of the check item.

Badges

A Trello Badges Object

Name	Path	Type	Description
Votes	Votes	integer	The number of votes on the card badges.
Viewing Member Voted	ViewingMemberVoted	boolean	A boolean value (true, false) determining whether or not viewing members voted on the badge.
Subscribed To Badge	Subscribed	boolean	A boolean value (true, false) determining whether or not the account is subscribed to the card badges.
Fogbugz	Fogbugz	string	The fogbugz of the badges.
Check Items	CheckItems	integer	The number of check items in the badge.
Checked Check Items	CheckItemsChecked	integer	The number of checked check items in the badge.
Comments	Comments	integer	The comments on the badge.
Attachments	Attachments	integer	The attachments on the badge.
Description	Description	boolean	The description of the badge.
Due Date	Due	date-time	The due date of the badge.

Board

A Trello Board Object

Name	Path	Type	Description
Board Id	id	string	The unique Id of the board.
Is Closed	closed	boolean	A boolean value (true, false) determining whether or not the board is closed.
Last Activity Date	dateLastActivity	date-time	Date of the last activity on the board.
Last Viewed Date	dateLastView	date-time	Date of the last time the board is viewed.
Board Description	desc	string	The description of the board.
Organization Id	idOrganization	string	The id of the organization.
Invitations	invitations	array of string	The list of invitations on the board.
Invited	invited	boolean	A boolean value (true, false) determining whether or not the account is invited to the board.
labelNames	labelNames	Label	A Trello Label Object
Board Memberships	memberships	array of Membership	The set of board memberships.
Board Name	name	string	The name of the board.
Is Board Pinned	pinned	boolean	A boolean value (true, false) determining whether or not the board is pinned.
Powerups	powerUps	array of string	The set of power ups on the board.
perfs	perfs	Perfs	A Trello Perfs Object
Board Short Link	shortLink	string	The short link of the board.
Board Short Url	shortUrl	string	The short url to the board.
Is Starred	starred	boolean	A value determining whether or not the board is starred.
Subscribed To Board	subscribed	boolean	A value determining whether or not the account is subscribed to the board.
Board Url	url	string	The full url of the board.

BoardWithChecklists

A Trello Board Object

Name	Path	Type	Description
Board Id	id	string	The unique Id of the board.
Is Closed	closed	boolean	A boolean value (true, false) determining whether or not the board is closed.
Last Activity Date	dateLastActivity	date-time	Date of the last activity on the board.
Last Viewed Date	dateLastView	date-time	Date of the last time the board is viewed.
Board Description	desc	string	The description of the board.
Organization Id	idOrganization	string	The id of the organization.
Invitations	invitations	array of string	The list of invitations on the board.
Invited	invited	boolean	A boolean value (true, false) determining whether or not the account is invited to the board.
labelNames	labelNames	Label	A Trello Label Object
Board Memberships	memberships	array of Membership	The set of board memberships.
Board Name	name	string	The name of the board.
Is Board Pinned	pinned	boolean	A boolean value (true, false) determining whether or not the board is pinned.
Powerups	powerUps	array of string	The set of power ups on the board.
perfs	perfs	Perfs	A Trello Perfs Object
Board Short Link	shortLink	string	The short link of the board.
Board Short Url	shortUrl	string	The short url to the board.
Is Starred	starred	boolean	A value determining whether or not the board is starred.
Subscribed To Board	subscribed	boolean	A value determining whether or not the account is subscribed to the board.
Board Url	url	string	The full url of the board.
Checklists	checklists	array of Checklist	The set of board checklists.

Label

A Trello Label Object

Name	Path	Type	Description
Green Label	green	string	The value of the green label.
Yellow Label	yellow	string	The value of the yellow label.
Orange Label	orange	string	The value of the orange label.
Red Label	red	string	The value of the red label.
Purple Label	purple	string	The value of the purple label.
Blue Label	blue	string	The value of the blue label.
Sky Blue Label	sky	string	The value of the sky blue label.
Lime Green Label	lime	string	The value of the lime green label.
Pink Label	pink	string	The value of the pink label.
Black Label	black	string	The value of the black label.

Membership

A Trello Membership Object

Name	Path	Type	Description
Membership Id	id	string	The unique Id of the membership.
Member Id	idMember	string	The unique Id of the member.
Member type	memberType	string	The type of member.
Unconfirmed Membership	unconfirmed	boolean	A boolean value (true, false) determining whether or not the membership is unconfirmed.

Perfs

A Trello Perfs Object

Name	Path	Type	Description
Permission Level	permissionLevel	string	The permission level of the object.
Voting Permission	voting	string	Who can vote on the object.
Commenting Permission	comments	string	Who can comment on the object.
Invitation Permission	invitations	string	Who can invite people to the object.
Self Join Permission	selfJoin	boolean	A boolean value (true, false) determining whether or not the object can self join.
Can Access Card Covers	cardCovers	boolean	A boolean value (true, false) determining whether or not the object has access to card covers.
Is Calendar Feed Enabled	calendarFeedEnabled	boolean	A boolean value (true, false) determining whether or not the calendar feed enabled.
Object Background	background	string	The background of the object.
Object Background Color	backgroundColor	string	The background color of the object, in hex notation.
Object Background Image	backgroundImage	string	The background image of the object.
Scaled Background Image	backgroundImageScaled	string	The scaled version of the background image.
Object Background Tile	backgroundTile	boolean	The background tile of the object.
Background Brightness	backgroundBrightness	string	The brightness of the object background.
Can Object be Public	canBePublic	boolean	A boolean value (true, false) determining whether or not the object can be public.
Can be Part of Organization	canBeOrg	boolean	A boolean value (true, false) determining whether or not the object can be part of the organization
Can Object be Private	canBePrivate	boolean	A boolean value (true, false) determining whether or not the object can be private.
Can Invite	canInvite	boolean	A boolean value (true, false) determining whether or not the object can have invititations.

List

A Trello List Object

Name	Path	Type	Description
List Id	id	string	The unique Id of the list.
List Name	name	string	The name of the list.
Is Closed	closed	boolean	A boolean value (true, false) determining whether or not the list is closed.
Board Id	idBoard	string	The unique Id of the board which the list belongs to.
List Position	pos	double	The position of the list.
Is List Subscribed To	subscribed	boolean	A boolean value (true, false) determining whether or not to the account is subscribed to the list.
Cards In List	cards	array of Card	The cards inside the list.
board	board	Board	A Trello Board Object

CreateListResponse

A Trello List Object

Name	Path	Type	Description
List Id	id	string	The unique Id of the list.
List Name	name	string	The name of the list.
Board Id	idBoard	string	The unique Id of the board the list belongs to.
List Position	pos	double	The position of the list.

Team

A Trello Team

Name	Path	Type	Description
Team Id	id	string	The unique ID of the team.
Team Description	desc	string	The description of the team.
Team Display Name	displayName	string	The display name of the team.
Board Ids	idBoards	array of string	The boards assigned to this team.
Member Count	billableMemberCount	integer	The number of members in this team.
Memberships	memberships	array of Membership	The memberships for this team.
Website	WebSite	string	The team website.
prefs	prefs	TeamPreferences	A Trello Team Preference Object

TeamPreferences

A Trello Team Preference Object

Name	Path	Type	Description
Permission Level	permissionLevel	string	The permission level of the team.

Member

A Trello Member Object

Name	Path	Type	Description
Member Id	id	string	The unique Id of the member.
Full Name	fullName	string	The full name of the member.
Username	username	string	The username of the member.
Initials	initials	string	The initials of the member.

BoardLabel

A Trello Label Object

Name	Path	Type	Description
Label Id	id	string	The Label Id
Label name	name	string	The Label name.
Label color	color	string	The Label color.

Comment

The model for getting a comment

Name	Path	Type	Description
memberCreator	memberCreator	Member	A Trello Member Object
Comment Text	text	string	The text of the comment.
Datetime Created	date	date-time	The datetime the comment was left.

Checklist

A Trello Checklist Object

Name	Path	Type	Description
Checklist Id	id	string	The unique Id of the checklist.
Checklist name	name	string	The name of the checklist.
Checklist position	pos	integer	The position of the checklist.
Board Id	idBoard	string	The unique Id of the board.
Card Id	idCard	string	The unique Id of the card.
Checkitems	checkItems	array of Checkitem	The list of the checklist items

Checkitem

A Trello Checkitem Object

Name	Path	Type	Description
Checkitem Id	id	string	The unique Id of the checkitem.
Checkitem name	name	string	The name of them checkitem.
Checkitem nameData	nameData	object	The nameData of them checkitem.
Checkitem position	pos	double	The position of the checkitem.
Checkitem state	state	string	The state of the checkitem.
Checkitem due date	due	string	The due date of the checkitem.
Member Id	idMember	string	The unique Id of the member.
Checklist Id	idChecklist	string	The unique Id of the checklist.

object

This is the type 'object'.

Partilhar via

Trello

Throttling Limits

Actions

A simple version of list lists

Parameters

Returns

A simple version of the list boards

Returns

A simple version of the list cards

Parameters

Returns

Add a comment to a card

Parameters

Returns

Add member to a card

Parameters

Returns

Close a board

Parameters

Returns

Create a board

Parameters

Returns

Create a card

Parameters

Returns

Create a card [DEPRECATED]

Parameters

Returns

Create a list

Parameters

Returns

Delete a card

Parameters

Returns

Get a board by Id

Parameters

Returns

Get a card by id

Parameters

Returns

Get list by Id

Parameters

Returns

Get the team for a board

Parameters

Returns

Get your User Profile info

Parameters

Returns

List boards

Parameters

Returns

List comments for a card

Parameters

Returns

List labels of a board

Parameters

Returns

List members for a card

Parameters

Returns

List members of a board

Parameters

Returns

List members of a team

Parameters

Returns

List teams you are a member of

Returns

List the card lists in a board

Parameters

Returns

List the cards in a board

Parameters

Returns

Update a board

Parameters

Returns