> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runalloy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Trello

> Integration details and setup guide for the Trello connector in Alloy Automation.

## Pre-Built Tooling

| Category                            | Details                                     |
| ----------------------------------- | ------------------------------------------- |
| **Authentication**                  | OAuth 1.0a or API Key + Token               |
| **Two-Way Sync**                    | Yes                                         |
| **Events Supported**                | Yes (via Webhooks)                          |
| **Realtime**                        | Yes (Webhooks)                              |
| **Supports Rate Limiting**          | Yes (100 requests per 10 seconds per token) |
| **Authentication Scopes Supported** | `read`, `write`, `account`                  |

***

## Objects Supported

* **Boards** - Trello boards
* **Lists** - Lists within boards
* **Cards** - Tasks/cards with descriptions, due dates, attachments
* **Members** - Board and organization members
* **Checklists** - Card checklists and items
* **Labels** - Card labels and categories
* **Organizations** - Trello teams/workspaces

***

## Set Up Guide

### Trial Access

| Question                                           | Answer                                                                                                                               |
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| **Offers free trial?**                             | Yes. Trello offers a free tier with unlimited cards and up to 10 boards per workspace. [Sign up for free](https://trello.com/signup) |
| **Requires paid sandbox**                          | No. Free tier can be used for development.                                                                                           |
| **Requires partnership to obtain authentication?** | No. Anyone can create Power-Ups and obtain API credentials.                                                                          |

***

### Authentication (API Key + Token)

<step>
  ## Step 1: Get Your API Key

  1. Log into Trello ([https://trello.com/](https://trello.com/))
  2. Visit [https://trello.com/app-key](https://trello.com/app-key)
  3. Copy your **API Key**
  4. Note the **API Secret** (needed for OAuth, if applicable)
</step>

<step>
  ## Step 2: Generate a Token

  1. On the same page, click the **Token** link
  2. Authorize the token with the required scopes (`read`, `write`, `account`)
  3. Set token expiration (or select "Never" for permanent tokens)
  4. Click **Allow**
  5. Copy the generated token
</step>

<step>
  ## Step 3: Connect to Alloy Automation

  1. In Alloy Automation, provide your **API Key** and **Token**
  2. Test the connection by retrieving boards or cards
</step>

***

## Use Cases

### 1) Project management synchronization

Sync Trello cards with project management tools, CRMs, or issue trackers to maintain consistent task data across platforms.

### 2) Automated workflow triggers

Trigger actions in external systems when cards move between lists, are assigned, or reach due dates.

### 3) Customer feedback tracking

Create Trello cards from customer support tickets, feedback forms, or social media mentions for team triage and prioritization.

### 4) Sprint and release planning

Integrate Trello with development tools to sync sprint boards, release planning cards, and bug tracking.

### 5) Content calendar management

Use Trello as a content calendar and sync publication schedules with CMSs, social media platforms, or email marketing tools.

***

## API Gotchas

* **Rate Limiting:** Trello allows 100 requests per 10 seconds per token. Exceeding this returns 429 errors. Implement request queuing and exponential backoff.

* **Webhook Expiration:** Trello webhooks expire if they fail consistently. Monitor webhook health and re-register webhooks if they stop firing.

* **Card Position Changes:** Moving cards between lists or reordering requires specific `pos` values ("top", "bottom", or numeric position). Incorrect values may result in unexpected card placement.

> For questions or troubleshooting, contact **[support@runalloy.com](mailto:support@runalloy.com)**.