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<br/>, addAttachmentToCard<br/>, addChecklistToCard<br/>, addLabelToCard<br/>, addMemberToBoard<br/>, addMemberToCard<br/>, addMemberToOrganization<br/>, addOrganizationToEnterprise<br/>, addToEnterprisePluginWhitelist<br/>, addToOrganizationBoard<br/>, commentCard<br/>, convertToCardFromCheckItem<br/>, copyBoard<br/>, copyCard<br/>, copyChecklist<br/>, createLabel<br/>, copyCommentCard<br/>, createBoard<br/>, createBoardInvitation<br/>, createBoardPreference<br/>, createCard<br/>, createList<br/>, createOrganization<br/>, createOrganizationInvitation<br/>, deleteAttachmentFromCard<br/>, deleteBoardInvitation<br/>, deleteCard<br/>, deleteCheckItem<br/>, deleteLabel<br/>, deleteOrganizationInvitation<br/>, disableEnterprisePluginWhitelist<br/>, disablePlugin<br/>, disablePowerUp<br/>, emailCard<br/>, enableEnterprisePluginWhitelist<br/>, enablePlugin<br/>, enablePowerUp<br/>, makeAdminOfBoard<br/>, makeAdminOfOrganization<br/>, makeNormalMemberOfBoard<br/>, makeNormalMemberOfOrganization<br/>, makeObserverOfBoard<br/>, memberJoinedTrello<br/>, moveCardFromBoard<br/>, moveCardToBoard<br/>, moveListFromBoard<br/>, moveListToBoard<br/>, removeAdminFromBoard (Deprecated in favor of makeNormalMemberOfBoard) removeAdminFromOrganization (Deprecated in favor of - makeNormalMemberOfOrganization)<br/>, removeChecklistFromCard<br/>, removeFromEnterprisePluginWhitelist<br/>, removeFromOrganizationBoard<br/>, removeLabelFromCard<br/>, removeMemberFromBoard<br/>, removeMemberFromCard<br/>, removeMemberFromOrganization<br/>, removeOrganizationFromEnterprise<br/>, unconfirmedBoardInvitation<br/>, unconfirmedOrganizationInvitation<br/>, updateBoard<br/>, updateCard<br/>, updateCheckItem<br/>, updateCheckItemStateOnCard<br/>, updateChecklist<br/>, updateLabel<br/>, updateList<br/>, updateMember<br/>, 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

```json
{
    "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 |

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

```json
{
    "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 |

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

```json
{
    "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 |