Trello

This Integration is part of the Trello Pack.#

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 in Cortex#

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

Parameter	Description	Required
Server URL (e.g. https://example.net)		True
Fetch incidents		False
Use system proxy settings		False
Default and Fetch Board ID	ID of Trello board used both to fetch incidents and as the default for all integration commands.	False
API Key		False
List to Fetch Incidents from	Optional - 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 type		False

Commands#

You can execute these commands from the 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#

Path	Type	Description
Trello.Boards.Id	Unknown	The board ID
Trello.Boards.Name	Unknown	Board name
Trello.Boards.Closed	Unknown	Bool - True if board closed.
Trello.Boards.DateLastActivity	Unknown	The 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#
id name dateLastActivity
5f84cf4db437823603f98ad0 Current Tasks 2021-03-24T04:38:20.193Z
602f2f91cc8a4e23e393556a Devel 2021-03-29T05:18:09.118Z
5ea81000966eeb7e86362b35 MOXSOAR 2020-12-06T23:15:15.945Z
5f0fc9c1e1ca6e3eef34913d XSOAR 2021-03-29T00:28:52.283Z

id	name	dateLastActivity
5f84cf4db437823603f98ad0	Current Tasks	2021-03-24T04:38:20.193Z
602f2f91cc8a4e23e393556a	Devel	2021-03-29T05:18:09.118Z
5ea81000966eeb7e86362b35	MOXSOAR	2020-12-06T23:15:15.945Z
5f0fc9c1e1ca6e3eef34913d	XSOAR	2021-03-29T00:28:52.283Z

trello-list-lists#

List all the lists associated with the trello board.

Base Command#

trello-list-lists

Input#

Argument Name	Description	Required
board_id	Optional - the ID of the board to query, if not provided will use configured .	Optional

Context Output#

Path	Type	Description
Trello.Lists.Id	Unknown	List ID
Trello.Lists.Name	Unknown	List Name
Trello.Lists.Closed	Unknown	Bool - True if list is closed
Trello.Lists.IdBoard	Unknown	ID 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#
closed id idBoard name pos softLimit subscribed
false 606120363e1eb362adcfdb47 602f2f91cc8a4e23e393556a New Tasks 65535.5 false
false 605d2a706398646de27a1f8f 602f2f91cc8a4e23e393556a Created by XSOAR 98303.25 false
false 603c6dcfe6f2ef24e161d31f 602f2f91cc8a4e23e393556a Xsoar to Investigate 131071 false
false 605ac66f9f37c20f9f3205d9 602f2f91cc8a4e23e393556a Completed List 196607 false

closed	id	idBoard	name	pos	subscribed
false	606120363e1eb362adcfdb47	602f2f91cc8a4e23e393556a	New Tasks	65535.5	false
false	605d2a706398646de27a1f8f	602f2f91cc8a4e23e393556a	Created by XSOAR	98303.25	false
false	603c6dcfe6f2ef24e161d31f	602f2f91cc8a4e23e393556a	Xsoar to Investigate	131071	false
false	605ac66f9f37c20f9f3205d9	602f2f91cc8a4e23e393556a	Completed List	196607	false

trello-create-card#

Create a new card.

Base Command#

trello-create-card

Input#

Argument Name	Description	Required
name	Card name.	Required
desc	Card Description - Markdown Compatible.	Optional
list_id	ID of list to create card within.	Required
idLabels	CSV list of Labels (by ID) to add to the card. Use trello-list-labels command to display.	Optional

Context Output#

Path	Type	Description
Trello.CreatedCard.Id	Unknown	ID of created card
Trello.CreatedCard.Name	Unknown	Name of created card
Trello.CreatedCard.Url	Unknown	URL Of created card
Trello.CreatedCard.IdList	Unknown	ID 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 Name	Description	Required
card_id	ID of card to be updated.	Required
closed	If true, archives the card. Possible values are: true, false.	Optional
idLabels	CSV Of Trello Label IDs to add to card.	Optional
idList	ID Of list to move card to.	Optional

Context Output#

Path	Type	Description
Trello.UpdatedCard.Id	Unknown	ID of Updated Card
Trello.UpdatedCard.Name	Unknown	Name of updated card

Command Example#

Human Readable Output#

trello-delete-card#

Delete a card

Base Command#

trello-delete-card

Input#

Argument Name	Description	Required
card_id	ID 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 Name	Description	Required
board_id	Optional - the ID of the board to query, if not provided will use configured .	Optional
filter	CSV 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
since	First action time.	Optional
before	Last action time.	Optional

Context Output#

Path	Type	Description
Trello.Actions.Id	Unknown	Action ID
Trello.Actions.Type	Unknown	Type of action
Trello.Actions.Date	Date	Date of action
Trello.Actions.ListId	Unknown	List ID - Null if not card or list action
Trello.Actions.CardId	Unknown	Card ID - Null if not card action
Trello.Actions.BoardId	Unknown	Board 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#
id type date
606163113a492b52f69c40df createCard 2021-03-29T05:18:09.138Z
6061628bedda298c34aa588e createCard 2021-03-29T05:15:55.706Z

id	type	date
606163113a492b52f69c40df	createCard	2021-03-29T05:18:09.138Z
6061628bedda298c34aa588e	createCard	2021-03-29T05:15:55.706Z

trello-list-labels#

List all the labels in a given board

Base Command#

trello-list-labels

Input#

Argument Name	Description	Required
board_id	Optional - Board ID.	Optional

Context Output#

Path	Type	Description
Trello.Labels.Id	Unknown	Label ID
Trello.Labels.Name	Unknown	Label Name
Trello.Labels.Color	Unknown	Label 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#
color id idBoard name
green 60596b0b080907067c65c0ee 602f2f91cc8a4e23e393556a Low
green 603c6bd95984232d2a060953 602f2f91cc8a4e23e393556a test-xsoar-label
pink 6059585c1b00040da553cd77 602f2f91cc8a4e23e393556a LabelFromXsoar
orange 605973a683fc7129761f000b 602f2f91cc8a4e23e393556a High
red 602f2f9186c6bc9cc5d3d1d1 602f2f91cc8a4e23e393556a
yellow 60596d0a7dc72638aea5ef8d 602f2f91cc8a4e23e393556a Medium
orange 602f2f9186c6bc9cc5d3d1d0 602f2f91cc8a4e23e393556a
green 602f2f9186c6bc9cc5d3d1cb 602f2f91cc8a4e23e393556a
purple 602f2f9186c6bc9cc5d3d1d4 602f2f91cc8a4e23e393556a
blue 602f2f9186c6bc9cc5d3d1d6 602f2f91cc8a4e23e393556a
yellow 602f2f9186c6bc9cc5d3d1ce 602f2f91cc8a4e23e393556a
green 6059493cd83e275095800912 602f2f91cc8a4e23e393556a Testlabel
606162c31caee583b35a0772 602f2f91cc8a4e23e393556a Test label

color	id	idBoard	name
green	60596b0b080907067c65c0ee	602f2f91cc8a4e23e393556a	Low
green	603c6bd95984232d2a060953	602f2f91cc8a4e23e393556a	test-xsoar-label
pink	6059585c1b00040da553cd77	602f2f91cc8a4e23e393556a	LabelFromXsoar
orange	605973a683fc7129761f000b	602f2f91cc8a4e23e393556a	High
red	602f2f9186c6bc9cc5d3d1d1	602f2f91cc8a4e23e393556a
yellow	60596d0a7dc72638aea5ef8d	602f2f91cc8a4e23e393556a	Medium
orange	602f2f9186c6bc9cc5d3d1d0	602f2f91cc8a4e23e393556a
green	602f2f9186c6bc9cc5d3d1cb	602f2f91cc8a4e23e393556a
purple	602f2f9186c6bc9cc5d3d1d4	602f2f91cc8a4e23e393556a
blue	602f2f9186c6bc9cc5d3d1d6	602f2f91cc8a4e23e393556a
yellow	602f2f9186c6bc9cc5d3d1ce	602f2f91cc8a4e23e393556a
green	6059493cd83e275095800912	602f2f91cc8a4e23e393556a	Testlabel
	606162c31caee583b35a0772	602f2f91cc8a4e23e393556a	Test label

trello-create-label#

Create a new trello label

Base Command#

trello-create-label

Input#

Argument Name	Description	Required
board_id	Optional - Board ID.	Optional
name	Name of Label.	Required
color	Label Color. Possible values are: yellow, purple, blue, red, green, orange, black, sky, pink, lime.	Optional

Context Output#

Path	Type	Description
Trello.CreatedLabel.Id	Unknown	ID Of created label
Trello.CreatedLabel.Name	Unknown	Name 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 Name	Description	Required
text	Comment to add.	Required
card_id	Card to add comment to.	Optional

Context Output#

Path	Type	Description
Trello.AddedComment.Id	Unknown	ID Of comment action
Trello.AddedComment.Date	Unknown	Date of comment

Command Example#

Human Readable Output#

trello-list-cards#

List all the trello cards

Base Command#

trello-list-cards

Input#

Argument Name	Description	Required
list_id	ID of list containing cards.	Optional

Context Output#

Path	Type	Description
Trello.Cards.Id	Unknown	Card ID
Trello.Cards.Name	Unknown	Card Name
Trello.Cards.IdList	Unknown	ID of parent list
Trello.Cards.Due	Date	Due date of card
Trello.Cards.Labels	Unknown	List of labels associated with card
Trello.Cards.Desc	Unknown	Card description
Trello.Cards.Start	Date	Card Start date
Trello.Cards.Labels.id	Unknown	Label 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#
id name url
6061628bedda298c34aa588d Temp card https://trello.com/c/oq5kliob/99-temp-card
606163113a492b52f69c40de This is a test card from XSOAR! https://trello.com/c/63F5dXGw/100-this-is-a-test-card-from-xsoar

id	name	url
6061628bedda298c34aa588d	Temp card	https://trello.com/c/oq5kliob/99-temp-card
606163113a492b52f69c40de	This is a test card from XSOAR!	https://trello.com/c/63F5dXGw/100-this-is-a-test-card-from-xsoar