> For the complete documentation index, see [llms.txt](https://docs.planetcrust.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.planetcrust.com/human-connections/trello/trello.md).
# Trello
Put Trello to Work with @Human Automations and @Human Agents
The Trello Connection documents all Triggers, Actions and Query Operations available for creating automations via the Trello API.
{% embed url="" %}
#### What can you do with the \[Name] Connection?
* Connect to the Trello API in a few clicks
* Use the related Trello Operations (see below) in @Human Automations or @Human Agents
### Related Operations
#### Trigger Operations
**Board Created**
Triggers on: boards/boardCreated
Triggered when a new board is created in Trello.
**List Created**
Triggers on: lists/listCreated
Triggered when a new list is created on a Trello board.
**Card Created**
Triggers on: cards/cardCreated
Triggered when a new card is created on a Trello list.
#### Action Operations
[Query: Get a Board](/human-connections/trello/trello/query-get-a-board.md)
[Action: Create a Board](/human-connections/trello/trello/action-create-a-board.md)
[Action: Update a Board](/human-connections/trello/trello/action-update-a-board.md)
[Query: Get a Card](/human-connections/trello/trello/query-get-a-card.md)
[Action: Create a New Card](/human-connections/trello/trello/action-create-a-new-card.md)
[Action: Update a Card](/human-connections/trello/trello/action-update-a-card.md)
#### Query Operations
Example link
### Related Automations
Example link
### Obtaining Access Credentials
To obtain a **system-to-system Personal Access Token (PAT)** for **Trello**, follow these steps:
1. **Log in** to your Trello account at (ensure you use the account with the required board permissions).
2. Navigate to your **Profile** by clicking your avatar (top-right) → **"Settings"**.
3. Scroll to the **"Developer API Keys"** section and click **"Generate an API Key"**.
4. Copy the generated **API Key** (keep this secure).
5. Below the API Key, click **"Token"** (or **"Generate a Token"** if not visible).
6. Authorize the token by confirming permissions (ensure it includes the required scopes for your use case).
7. Copy the generated **Token** (this is your PAT).
**Done.** Use the **API Key + Token** for system-to-system authentication.
### Configuring Webhooks
1. **Obtain your API Key and User Token** by following the steps in the **Obtaining Access Credentials** section.
2. **Prepare a publicly accessible callback URL** that responds with a **200 OK** status to HTTP **HEAD** requests from Trello.
3. **Identify the ID** of the Trello model (board, card, or list) you want to monitor.
4. **Send an HTTP POST request** to `https://api.trello.com/1/webhooks/` with your **API Key**, **Token**, **callbackURL**, and **idModel** as parameters.
### Code (Apache v2.0): Service Connectivity and Metadata
```
{
"handle": "trello-api-v1",
"status": "active",
"meta": {
"short": "Trello API",
"description": "Connect to Trello's API to manage boards, lists, cards, and more.",
"icon": "trello",
"tags": ["project-management", "task-management", "collaboration"]
},
"service": {
"baseURL": {
"value": "https://api.trello.com/1"
},
"protocol": "https",
"contentType": "application/json",
"headers": {
"Accept": {
"value": "application/json"
}
},
"auth": {
"method": "system_to_system",
"params": {}
}
}
}
```
### Code (Apache v2.0): List of External Resources and Internal Mapping
```
[
{
"handle": "boards",
"meta": {
"short": "Boards",
"description": "Represents a board in Trello, which contains lists and cards."
},
"endpoint": {
"value": "/boards/{{boardId}}",
"placeholders": [
{
"name": "boardId",
"type": "String",
"description": "The ID of the board",
"required": true
}
]
},
"fields": [
{
"name": "id",
"type": "String",
"selector": ["id"],
"meta": {
"description": "The unique identifier for the board"
}
},
{
"name": "name",
"type": "String",
"selector": ["name"],
"meta": {
"description": "The name of the board"
}
},
{
"name": "description",
"type": "String",
"selector": ["desc"],
"meta": {
"description": "The description of the board"
}
}
],
"operations": {
"list": {
"method": "GET",
"path": {
"value": "/members/{{memberId}}/boards",
"placeholders": [
{
"name": "memberId",
"type": "String",
"description": "The ID of the member",
"required": true
}
]
},
"queryParams": {
"fields": "name,desc",
"filter": "open"
}
},
"read": {
"method": "GET",
"path": {
"value": "/boards/{{boardId}}",
"placeholders": [
{
"name": "boardId",
"type": "String",
"description": "The ID of the board",
"required": true
}
]
},
"queryParams": {
"fields": "name,desc"
}
},
"create": {
"method": "POST",
"path": {
"value": "/boards"
},
"bodyTemplate": {
"value": "{\"name\": \"{{name}}\", \"defaultLists\": {{defaultLists}}, \"desc\": \"{{description}}\"}",
"placeholders": [
{
"name": "name",
"type": "String",
"description": "The name of the board",
"required": true
},
{
"name": "defaultLists",
"type": "Boolean",
"description": "Whether to create default lists",
"required": false,
"default": "true"
},
{
"name": "description",
"type": "String",
"description": "The description of the board",
"required": false
}
]
}
},
"update": {
"method": "PUT",
"path": {
"value": "/boards/{{boardId}}",
"placeholders": [
{
"name": "boardId",
"type": "String",
"description": "The ID of the board",
"required": true
}
]
},
"bodyTemplate": {
"value": "{\"name\": \"{{name}}\", \"desc\": \"{{description}}\"}",
"placeholders": [
{
"name": "name",
"type": "String",
"description": "The name of the board",
"required": false
},
{
"name": "description",
"type": "String",
"description": "The description of the board",
"required": false
}
]
}
},
"delete": {
"method": "DELETE",
"path": {
"value": "/boards/{{boardId}}",
"placeholders": [
{
"name": "boardId",
"type": "String",
"description": "The ID of the board",
"required": true
}
]
}
}
},
"webhooks": [
{
"event": "boardCreated",
"path": "/webhooks/trello/boardCreated",
"payload": [
{
"name": "boardId",
"type": "String",
"selector": ["action", "data", "board", "id"],
"meta": {
"description": "The ID of the board that was created"
}
},
{
"name": "boardName",
"type": "String",
"selector": ["action", "data", "board", "name"],
"meta": {
"description": "The name of the board that was created"
}
}
]
}
]
},
{
"handle": "lists",
"meta": {
"short": "Lists",
"description": "Represents a list on a Trello board, which contains cards."
},
"endpoint": {
"value": "/lists/{{listId}}",
"placeholders": [
{
"name": "listId",
"type": "String",
"description": "The ID of the list",
"required": true
}
]
},
"fields": [
{
"name": "id",
"type": "String",
"selector": ["id"],
"meta": {
"description": "The unique identifier for the list"
}
},
{
"name": "name",
"type": "String",
"selector": ["name"],
"meta": {
"description": "The name of the list"
}
},
{
"name": "closed",
"type": "Boolean",
"selector": ["closed"],
"meta": {
"description": "Whether the list is closed"
}
}
],
"operations": {
"list": {
"method": "GET",
"path": {
"value": "/boards/{{boardId}}/lists",
"placeholders": [
{
"name": "boardId",
"type": "String",
"description": "The ID of the board",
"required": true
}
]
},
"queryParams": {
"fields": "name,closed"
}
},
"read": {
"method": "GET",
"path": {
"value": "/lists/{{listId}}",
"placeholders": [
{
"name": "listId",
"type": "String",
"description": "The ID of the list",
"required": true
}
]
},
"queryParams": {
"fields": "name,closed"
}
},
"create": {
"method": "POST",
"path": {
"value": "/lists"
},
"bodyTemplate": {
"value": "{\"name\": \"{{name}}\", \"idBoard\": \"{{boardId}}\", \"pos\": \"{{position}}\"}",
"placeholders": [
{
"name": "name",
"type": "String",
"description": "The name of the list",
"required": true
},
{
"name": "boardId",
"type": "String",
"description": "The ID of the board",
"required": true
},
{
"name": "position",
"type": "String",
"description": "The position of the list",
"required": false,
"default": "bottom"
}
]
}
},
"update": {
"method": "PUT",
"path": {
"value": "/lists/{{listId}}",
"placeholders": [
{
"name": "listId",
"type": "String",
"description": "The ID of the list",
"required": true
}
]
},
"bodyTemplate": {
"value": "{\"name\": \"{{name}}\", \"closed\": {{closed}}}",
"placeholders": [
{
"name": "name",
"type": "String",
"description": "The name of the list",
"required": false
},
{
"name": "closed",
"type": "Boolean",
"description": "Whether the list is closed",
"required": false
}
]
}
},
"delete": {
"method": "DELETE",
"path": {
"value": "/lists/{{listId}}",
"placeholders": [
{
"name": "listId",
"type": "String",
"description": "The ID of the list",
"required": true
}
]
},
"queryParams": {
"value": true
}
}
},
"webhooks": [
{
"event": "listCreated",
"path": "/webhooks/trello/listCreated",
"payload": [
{
"name": "listId",
"type": "String",
"selector": ["action", "data", "list", "id"],
"meta": {
"description": "The ID of the list that was created"
}
},
{
"name": "listName",
"type": "String",
"selector": ["action", "data", "list", "name"],
"meta": {
"description": "The name of the list that was created"
}
}
]
}
]
},
{
"handle": "cards",
"meta": {
"short": "Cards",
"description": "Represents a card on a Trello list."
},
"endpoint": {
"value": "/cards/{{cardId}}",
"placeholders": [
{
"name": "cardId",
"type": "String",
"description": "The ID of the card",
"required": true
}
]
},
"fields": [
{
"name": "id",
"type": "String",
"selector": ["id"],
"meta": {
"description": "The unique identifier for the card"
}
},
{
"name": "name",
"type": "String",
"selector": ["name"],
"meta": {
"description": "The name of the card"
}
},
{
"name": "description",
"type": "String",
"selector": ["desc"],
"meta": {
"description": "The description of the card"
}
},
{
"name": "due",
"type": "String",
"selector": ["due"],
"meta": {
"description": "The due date of the card"
}
}
],
"operations": {
"list": {
"method": "GET",
"path": {
"value": "/lists/{{listId}}/cards",
"placeholders": [
{
"name": "listId",
"type": "String",
"description": "The ID of the list",
"required": true
}
]
},
"queryParams": {
"fields": "name,desc,due"
}
},
"read": {
"method": "GET",
"path": {
"value": "/cards/{{cardId}}",
"placeholders": [
{
"name": "cardId",
"type": "String",
"description": "The ID of the card",
"required": true
}
]
},
"queryParams": {
"fields": "name,desc,due"
}
},
"create": {
"method": "POST",
"path": {
"value": "/cards"
},
"bodyTemplate": {
"value": "{\"name\": \"{{name}}\", \"idList\": \"{{listId}}\", \"desc\": \"{{description}}\", \"due\": \"{{dueDate}}\"}",
"placeholders": [
{
"name": "name",
"type": "String",
"description": "The name of the card",
"required": true
},
{
"name": "listId",
"type": "String",
"description": "The ID of the list",
"required": true
},
{
"name": "description",
"type": "String",
"description": "The description of the card",
"required": false
},
{
"name": "dueDate",
"type": "String",
"description": "The due date of the card",
"required": false
}
]
}
},
"update": {
"method": "PUT",
"path": {
"value": "/cards/{{cardId}}",
"placeholders": [
{
"name": "cardId",
"type": "String",
"description": "The ID of the card",
"required": true
}
]
},
"bodyTemplate": {
"value": "{\"name\": \"{{name}}\", \"desc\": \"{{description}}\", \"due\": \"{{dueDate}}\"}",
"placeholders": [
{
"name": "name",
"type": "String",
"description": "The name of the card",
"required": false
},
{
"name": "description",
"type": "String",
"description": "The description of the card",
"required": false
},
{
"name": "dueDate",
"type": "String",
"description": "The due date of the card",
"required": false
}
]
}
},
"delete": {
"method": "DELETE",
"path": {
"value": "/cards/{{cardId}}",
"placeholders": [
{
"name": "cardId",
"type": "String",
"description": "The ID of the card",
"required": true
}
]
}
}
},
"webhooks": [
{
"event": "cardCreated",
"path": "/webhooks/trello/cardCreated",
"payload": [
{
"name": "cardId",
"type": "String",
"selector": ["action", "data", "card", "id"],
"meta": {
"description": "The ID of the card that was created"
}
},
{
"name": "cardName",
"type": "String",
"selector": ["action", "data", "card", "name"],
"meta": {
"description": "The name of the card that was created"
}
}
]
}
]
}
]
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.planetcrust.com/human-connections/trello/trello.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.