Skip to main content

Trello

Supported versions

Supported Cortex XSOAR versions: 6.0.0 and later.

Interact with the Trello task manager This integration was integrated and tested with version 1.0.0 of Trello

Configure Trello on Cortex XSOAR#

First, retrieve an API key from the trello API page, by following this link For more information, see the following Trello documentation

  1. Navigate to Settings > Integrations > Servers & Services.

  2. Search for Trello.

  3. Click Add instance to create and configure a new integration instance.

    ParameterDescriptionRequired
    Server URL (e.g. https://example.net)True
    Fetch incidentsFalse
    Use system proxy settingsFalse
    Default and Fetch Board IDID of Trello board used both to fetch incidents and as the default for all integration commands.False
    API KeyFalse
    List to Fetch Incidents fromOptional - If specified, incidents will only be fetched when cards are created in this specific list. Use trello-list-lists command to display IDs of available lists in Board.False
    Incident typeFalse
  4. Click Test to validate the URLs, token, and connection.

Commands#

You can execute these commands from the Cortex XSOAR CLI, as part of an automation, or in a playbook. After you successfully execute a command, a DBot message appears in the War Room with the command details.

trello-list-boards#


List the boards available to the provided API Key

Base Command#

trello-list-boards

Input#

There are no input arguments for this command.

Context Output#

PathTypeDescription
Trello.Boards.IdUnknownThe board ID
Trello.Boards.NameUnknownBoard name
Trello.Boards.ClosedUnknownBool - True if board closed.
Trello.Boards.DateLastActivityUnknownThe last time this board was updated.

Command Example#

!trello-list-boards

Context Example#

{
"Trello": {
"Boards": [
{
"Closed": false,
"DateLastActivity": "2021-03-24T04:38:20.193Z",
"Id": "5f84cf4db437823603f98ad0",
"Name": "Current Tasks",
"Url": "https://trello.com/b/lGTEPWR6/current-tasks"
},
{
"Closed": false,
"DateLastActivity": "2021-03-29T05:18:09.118Z",
"Id": "602f2f91cc8a4e23e393556a",
"Name": "Devel",
"Url": "https://trello.com/b/RqO8rfpZ/devel"
},
{
"Closed": false,
"DateLastActivity": "2020-12-06T23:15:15.945Z",
"Id": "5ea81000966eeb7e86362b35",
"Name": "MOXSOAR",
"Url": "https://trello.com/b/L6eBwR31/moxsoar"
},
{
"Closed": false,
"DateLastActivity": "2021-03-29T00:28:52.283Z",
"Id": "5f0fc9c1e1ca6e3eef34913d",
"Name": "XSOAR",
"Url": "https://trello.com/b/WGwDIdS4/xsoar"
}
]
}
}

Human Readable Output#

Trello Boards#

idnamedateLastActivity
5f84cf4db437823603f98ad0Current Tasks2021-03-24T04:38:20.193Z
602f2f91cc8a4e23e393556aDevel2021-03-29T05:18:09.118Z
5ea81000966eeb7e86362b35MOXSOAR2020-12-06T23:15:15.945Z
5f0fc9c1e1ca6e3eef34913dXSOAR2021-03-29T00:28:52.283Z

trello-list-lists#


List all the lists associated with the trello board.

Base Command#

trello-list-lists

Input#

Argument NameDescriptionRequired
board_idOptional - the ID of the board to query, if not provided will use configured .Optional

Context Output#

PathTypeDescription
Trello.Lists.IdUnknownList ID
Trello.Lists.NameUnknownList Name
Trello.Lists.ClosedUnknownBool - True if list is closed
Trello.Lists.IdBoardUnknownID Of the board this list belongs to

Command Example#

!trello-list-lists

Context Example#

{
"Trello": {
"Lists": [
{
"Closed": false,
"Id": "606120363e1eb362adcfdb47",
"IdBoard": "602f2f91cc8a4e23e393556a",
"Name": "New Tasks"
},
{
"Closed": false,
"Id": "605d2a706398646de27a1f8f",
"IdBoard": "602f2f91cc8a4e23e393556a",
"Name": "Created by XSOAR"
},
{
"Closed": false,
"Id": "603c6dcfe6f2ef24e161d31f",
"IdBoard": "602f2f91cc8a4e23e393556a",
"Name": "Xsoar to Investigate"
},
{
"Closed": false,
"Id": "605ac66f9f37c20f9f3205d9",
"IdBoard": "602f2f91cc8a4e23e393556a",
"Name": "Completed List"
}
]
}
}

Human Readable Output#

Trello Lists#

closedididBoardnamepossoftLimitsubscribed
false606120363e1eb362adcfdb47602f2f91cc8a4e23e393556aNew Tasks65535.5false
false605d2a706398646de27a1f8f602f2f91cc8a4e23e393556aCreated by XSOAR98303.25false
false603c6dcfe6f2ef24e161d31f602f2f91cc8a4e23e393556aXsoar to Investigate131071false
false605ac66f9f37c20f9f3205d9602f2f91cc8a4e23e393556aCompleted List196607false

trello-create-card#


Create a new card.

Base Command#

trello-create-card

Input#

Argument NameDescriptionRequired
nameCard name.Required
descCard Description - Markdown Compatible.Optional
list_idID of list to create card within.Required
idLabelsCSV list of Labels (by ID) to add to the card. Use trello-list-labels command to display.Optional

Context Output#

PathTypeDescription
Trello.CreatedCard.IdUnknownID of created card
Trello.CreatedCard.NameUnknownName of created card
Trello.CreatedCard.UrlUnknownURL Of created card
Trello.CreatedCard.IdListUnknownID of list this card belongs to

Command Example#

Human Readable Output#

trello-update-card#


Update an existing card

Base Command#

trello-update-card

Input#

Argument NameDescriptionRequired
card_idID of card to be updated.Required
closedIf true, archives the card. Possible values are: true, false.Optional
idLabelsCSV Of Trello Label IDs to add to card.Optional
idListID Of list to move card to.Optional

Context Output#

PathTypeDescription
Trello.UpdatedCard.IdUnknownID of Updated Card
Trello.UpdatedCard.NameUnknownName of updated card

Command Example#

Human Readable Output#

trello-delete-card#


Delete a card

Base Command#

trello-delete-card

Input#

Argument NameDescriptionRequired
card_idID of card to delete.Optional

Context Output#

There is no context output for this command.

Command Example#

Human Readable Output#

trello-list-actions#


List all actions on a board, such as card updates, additions, and deletes.

Base Command#

trello-list-actions

Input#

Argument NameDescriptionRequired
board_idOptional - the ID of the board to query, if not provided will use configured .Optional
filterCSV of action types used to filter response. Possible values are: , acceptEnterpriseJoinRequest
, addAttachmentToCard
, addChecklistToCard
, addLabelToCard
, addMemberToBoard
, addMemberToCard
, addMemberToOrganization
, addOrganizationToEnterprise
, addToEnterprisePluginWhitelist
, addToOrganizationBoard
, commentCard
, convertToCardFromCheckItem
, copyBoard
, copyCard
, copyChecklist
, createLabel
, copyCommentCard
, createBoard
, createBoardInvitation
, createBoardPreference
, createCard
, createList
, createOrganization
, createOrganizationInvitation
, deleteAttachmentFromCard
, deleteBoardInvitation
, deleteCard
, deleteCheckItem
, deleteLabel
, deleteOrganizationInvitation
, disableEnterprisePluginWhitelist
, disablePlugin
, disablePowerUp
, emailCard
, enableEnterprisePluginWhitelist
, enablePlugin
, enablePowerUp
, makeAdminOfBoard
, makeAdminOfOrganization
, makeNormalMemberOfBoard
, makeNormalMemberOfOrganization
, makeObserverOfBoard
, memberJoinedTrello
, moveCardFromBoard
, moveCardToBoard
, moveListFromBoard
, moveListToBoard
, removeAdminFromBoard (Deprecated in favor of makeNormalMemberOfBoard) removeAdminFromOrganization (Deprecated in favor of - makeNormalMemberOfOrganization)
, removeChecklistFromCard
, removeFromEnterprisePluginWhitelist
, removeFromOrganizationBoard
, removeLabelFromCard
, removeMemberFromBoard
, removeMemberFromCard
, removeMemberFromOrganization
, removeOrganizationFromEnterprise
, unconfirmedBoardInvitation
, unconfirmedOrganizationInvitation
, updateBoard
, updateCard
, updateCheckItem
, updateCheckItemStateOnCard
, updateChecklist
, updateLabel
, updateList
, updateMember
, updateOrganization, voteOnCard.
Optional
sinceFirst action time.Optional
beforeLast action time.Optional

Context Output#

PathTypeDescription
Trello.Actions.IdUnknownAction ID
Trello.Actions.TypeUnknownType of action
Trello.Actions.DateDateDate of action
Trello.Actions.ListIdUnknownList ID - Null if not card or list action
Trello.Actions.CardIdUnknownCard ID - Null if not card action
Trello.Actions.BoardIdUnknownBoard ID

Command Example#

!trello-list-actions filter="createCard" since="2021-03-29T00:53:21.972Z"

Context Example#

{
"Trello": {
"Actions": [
{
"BoardId": "602f2f91cc8a4e23e393556a",
"CardId": "606163113a492b52f69c40de",
"Date": "2021-03-29T05:18:09.138Z",
"Id": "606163113a492b52f69c40df",
"ListId": "605d2a706398646de27a1f8f",
"Type": "createCard"
},
{
"BoardId": "602f2f91cc8a4e23e393556a",
"CardId": "6061628bedda298c34aa588d",
"Date": "2021-03-29T05:15:55.706Z",
"Id": "6061628bedda298c34aa588e",
"ListId": "605d2a706398646de27a1f8f",
"Type": "createCard"
}
]
}
}

Human Readable Output#

Trello Actions#

idtypedate
606163113a492b52f69c40dfcreateCard2021-03-29T05:18:09.138Z
6061628bedda298c34aa588ecreateCard2021-03-29T05:15:55.706Z

trello-list-labels#


List all the labels in a given board

Base Command#

trello-list-labels

Input#

Argument NameDescriptionRequired
board_idOptional - Board ID.Optional

Context Output#

PathTypeDescription
Trello.Labels.IdUnknownLabel ID
Trello.Labels.NameUnknownLabel Name
Trello.Labels.ColorUnknownLabel Color

Command Example#

!trello-list-labels

Context Example#

{
"Trello": {
"Labels": [
{
"Color": "green",
"Id": "60596b0b080907067c65c0ee",
"Name": "Low"
},
{
"Color": "green",
"Id": "603c6bd95984232d2a060953",
"Name": "test-xsoar-label"
},
{
"Color": "pink",
"Id": "6059585c1b00040da553cd77",
"Name": "LabelFromXsoar"
},
{
"Color": "orange",
"Id": "605973a683fc7129761f000b",
"Name": "High"
},
{
"Color": "red",
"Id": "602f2f9186c6bc9cc5d3d1d1",
"Name": ""
},
{
"Color": "yellow",
"Id": "60596d0a7dc72638aea5ef8d",
"Name": "Medium"
},
{
"Color": "orange",
"Id": "602f2f9186c6bc9cc5d3d1d0",
"Name": ""
},
{
"Color": "green",
"Id": "602f2f9186c6bc9cc5d3d1cb",
"Name": ""
},
{
"Color": "purple",
"Id": "602f2f9186c6bc9cc5d3d1d4",
"Name": ""
},
{
"Color": "blue",
"Id": "602f2f9186c6bc9cc5d3d1d6",
"Name": ""
},
{
"Color": "yellow",
"Id": "602f2f9186c6bc9cc5d3d1ce",
"Name": ""
},
{
"Color": "green",
"Id": "6059493cd83e275095800912",
"Name": "Testlabel"
},
{
"Color": null,
"Id": "606162c31caee583b35a0772",
"Name": "Test label"
}
]
}
}

Human Readable Output#

Trello Labels#

colorididBoardname
green60596b0b080907067c65c0ee602f2f91cc8a4e23e393556aLow
green603c6bd95984232d2a060953602f2f91cc8a4e23e393556atest-xsoar-label
pink6059585c1b00040da553cd77602f2f91cc8a4e23e393556aLabelFromXsoar
orange605973a683fc7129761f000b602f2f91cc8a4e23e393556aHigh
red602f2f9186c6bc9cc5d3d1d1602f2f91cc8a4e23e393556a
yellow60596d0a7dc72638aea5ef8d602f2f91cc8a4e23e393556aMedium
orange602f2f9186c6bc9cc5d3d1d0602f2f91cc8a4e23e393556a
green602f2f9186c6bc9cc5d3d1cb602f2f91cc8a4e23e393556a
purple602f2f9186c6bc9cc5d3d1d4602f2f91cc8a4e23e393556a
blue602f2f9186c6bc9cc5d3d1d6602f2f91cc8a4e23e393556a
yellow602f2f9186c6bc9cc5d3d1ce602f2f91cc8a4e23e393556a
green6059493cd83e275095800912602f2f91cc8a4e23e393556aTestlabel
606162c31caee583b35a0772602f2f91cc8a4e23e393556aTest label

trello-create-label#


Create a new trello label

Base Command#

trello-create-label

Input#

Argument NameDescriptionRequired
board_idOptional - Board ID.Optional
nameName of Label.Required
colorLabel Color. Possible values are: yellow, purple, blue, red, green, orange, black, sky, pink, lime.Optional

Context Output#

PathTypeDescription
Trello.CreatedLabel.IdUnknownID Of created label
Trello.CreatedLabel.NameUnknownName of created label

Command Example#

Human Readable Output#

trello-add-comment#


Add a comment to a Trello card

Base Command#

trello-add-comment

Input#

Argument NameDescriptionRequired
textComment to add.Required
card_idCard to add comment to.Optional

Context Output#

PathTypeDescription
Trello.AddedComment.IdUnknownID Of comment action
Trello.AddedComment.DateUnknownDate of comment

Command Example#

Human Readable Output#

trello-list-cards#


List all the trello cards

Base Command#

trello-list-cards

Input#

Argument NameDescriptionRequired
list_idID of list containing cards.Optional

Context Output#

PathTypeDescription
Trello.Cards.IdUnknownCard ID
Trello.Cards.NameUnknownCard Name
Trello.Cards.IdListUnknownID of parent list
Trello.Cards.DueDateDue date of card
Trello.Cards.LabelsUnknownList of labels associated with card
Trello.Cards.DescUnknownCard description
Trello.Cards.StartDateCard Start date
Trello.Cards.Labels.idUnknownLabel ID

Command Example#

!trello-list-cards list_id=605d2a706398646de27a1f8f

Context Example#

{
"Trello": {
"Cards": [
{
"Desc": "",
"Due": null,
"Id": "6061628bedda298c34aa588d",
"IdList": "605d2a706398646de27a1f8f",
"Labels": [],
"Name": "Temp card",
"Start": null,
"Url": "https://trello.com/c/oq5kliob/99-temp-card"
},
{
"Desc": "",
"Due": null,
"Id": "606163113a492b52f69c40de",
"IdList": "605d2a706398646de27a1f8f",
"Labels": [],
"Name": "This is a test card from XSOAR!",
"Start": null,
"Url": "https://trello.com/c/63F5dXGw/100-this-is-a-test-card-from-xsoar"
}
]
}
}

Human Readable Output#

Trello Cards#

idnameurl
6061628bedda298c34aa588dTemp cardhttps://trello.com/c/oq5kliob/99-temp-card
606163113a492b52f69c40deThis is a test card from XSOAR!https://trello.com/c/63F5dXGw/100-this-is-a-test-card-from-xsoar