# Trello

:::tip Available
This integration is active and ready to use in Frihet.
:::

Connect your Trello boards to Frihet. View boards, lists, and cards directly from your ERP to get project context when invoicing.

## What is it for?

With Trello integrated:

- **View boards** — View all your Trello boards from Frihet
- **View lists and cards** — Navigate your project structure
- **Context for invoicing** — View completed tasks before creating an invoice
- **Centralized visibility** — Without switching between applications

## Requirements

- **Active Trello account** — [trello.com](https://trello.com)
- **Trello API Key** — Obtained from the developer portal
- **Authorization token** — Generated when authorizing your application
- **Frihet Pro or higher**

## Connect Trello with Frihet

### Step 1: Get your API Key

1. Go to [trello.com/power-ups/admin](https://trello.com/power-ups/admin)
2. Log in to your Trello account
3. Click **New** to create a new Power-Up or integration
4. Fill in the fields:
   - **Name**: "Frihet ERP"
   - **Workspace**: Select your workspace
5. Once created, go to the **API Key** tab
6. Copy your **API Key**

### Step 2: Generate a Token

1. On the same page, next to the API Key, click the **Token** link
2. A Trello authorization page will open
3. Review the requested permissions and click **Allow**
4. Copy the generated **Token**

:::caution Two credentials
You need both: the **API Key** and the **Token**. Copy them before continuing.
:::

### Step 3: Configure in Frihet

1. Go to **Settings** → **Integrations**
2. Search for **Trello**
3. Click **Connect**
4. Enter your **API Key**
5. Enter your **Token**
6. Click **Verify connection**
7. If correct, you will see your boards listed

## How it works

Frihet uses the **Trello REST API** with query params authentication:

1. You provide API Key and Token
2. Frihet adds both as query parameters in each request: `?key=<api-key>&token=<token>`
3. Boards, lists, and cards are queried on demand
4. Both credentials are stored encrypted (AES-256-GCM) in Frihet

## Synchronized data

| Data | Direction | Frequency |
|------|-----------|------------|
| Boards | Trello → Frihet | On demand |
| Lists | Trello → Frihet | On demand |
| Cards | Trello → Frihet | On demand |
| Members | Trello → Frihet | With each query |

## Use cases

### Freelancer managing projects in Trello

You have a board per client with columns like "To Do", "In Progress", and "Completed". Before invoicing, you check the completed cards from Frihet to verify which work to include.

### Agency with client boards

Your team works with shared client boards. From Frihet, you can view the status of each board to know when a project is ready for invoicing.

### Verify deliverables before invoicing

Before issuing a project invoice, you check the cards of the corresponding board in Trello from Frihet. You confirm that all deliverables are completed.

## Features

### View boards

1. From Frihet, access the Trello section
2. You will see all boards your account has access to
3. Select a board to view its lists and cards

### View lists and cards

1. Select a board
2. Frihet displays the lists (columns) with their cards
3. Each card shows title, assigned members, and labels

### Navigate cards

1. Click on a card to see more details
2. View the description, checklist, comments, and attachments
3. Use this information as a reference when creating invoices

### API Limits

Frihet implements automatic throttling (100ms between requests) to respect Trello API limits. Queries to large boards may take a few additional seconds.

## Troubleshooting

### "Authentication error"

- Verify that the API Key and Token are correct
- The Token must correspond to the same account as the API Key
- If you revoked the Token, generate a new one and update it in Frihet

### "I don't see all my boards"

- Verify that your account has access to those boards in Trello
- Private boards of other members will not be visible
- If you are invited to a board, access depends on the board's permissions

### "The Token has expired"

- Trello tokens do not expire by default unless you configure them to
- If the token was manually revoked, generate a new one
- Go to [trello.com/power-ups/admin](https://trello.com/power-ups/admin) to manage tokens

### "I want to disconnect"

1. Go to **Settings** → **Integrations** → **Trello**
2. Click **Disconnect**
3. Optionally, revoke the Token from Trello in **Settings** → **Applications**

## Next steps

- [Connect Asana as a project management alternative](./asana)
- [Connect Notion for documentation](./notion)
- [Automate workflows with n8n](./n8n)