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

# Trello 

> Connect Trello boards to sync cards and manage Kanban workflows

Trello is a popular visual work management platform. Kasava integrates with Trello to bring your boards and cards into Products and enable linking cards to Plans and other Kasava entities.

## Capabilities

| Feature           | Description                             |
| ----------------- | --------------------------------------- |
| Card Sync         | Access all your Trello boards and cards |
| Create & Update   | Create and update cards from Kasava     |
| Status Sync       | Sync card status and progress           |
| Plan Linking      | Link Trello cards to Plans              |
| Real-time Updates | Webhooks for instant synchronization    |

## Connecting Trello

<Steps>
  <Step title="Navigate to Settings">
    Go to **Settings > Integrations** in the sidebar
  </Step>

  <Step title="Find Trello">
    In the **Task Management** section, locate the Trello integration card
  </Step>

  <Step title="Click Connect">
    Click the green **Connect** button (or **Connect with Trello** in the detailed view)
  </Step>

  <Step title="Authorize on Trello">
    You'll be redirected to Trello to authorize Kasava. Review the permissions and click **Allow**
  </Step>

  <Step title="Connection Complete">
    After authorization, you'll be redirected back to Kasava. The Trello card will show your connected account with a green "Active" badge.
  </Step>
</Steps>

<Note>
  Kasava uses secure token-based authentication. Your Trello password is never stored. You'll see which Trello account is connected, including your username and avatar.
</Note>

## What You Can Do Once Connected

After connecting Trello, you can:

* **Access all your Trello boards** - View and interact with your boards
* **Create and update cards** - Manage cards directly from Kasava
* **Sync card status** - Keep status in sync between platforms
* **Link cards to Plans** - Connect Trello cards to Kasava Plans

## Viewing Your Connection

Once connected, the Trello integration card shows:

* Your Trello profile name and avatar
* Username (@yourusername)
* Connection status (Active badge)
* Last used timestamp

## Linking Trello Cards to Plans

You can link Trello cards to Kasava Plans for cross-platform tracking:

<Steps>
  <Step title="Open a Plan">
    Navigate to an existing Plan or create a new one
  </Step>

  <Step title="Find the Link Option">
    Look for the Trello link option in the Plan details
  </Step>

  <Step title="Select a Card">
    Browse your Trello boards and select the card to link
  </Step>

  <Step title="Confirm Link">
    The card is now linked and will show Trello sync status
  </Step>
</Steps>

## Field Mapping

When cards sync between Trello and Kasava:

| Trello Field | Kasava Field       |
| ------------ | ------------------ |
| List         | Status column      |
| Members      | Assignees          |
| Labels       | Labels             |
| Due Date     | Due date           |
| Description  | Description        |
| Checklists   | Subtasks (preview) |

## Managing the Connection

### Testing Your Connection

To verify your Trello connection is working:

1. Go to **Settings > Integrations**
2. Find the connected Trello card
3. Click the **Test** button
4. A success message confirms the connection is active

### Opening Trello

Click **Open Trello** on the connected card to quickly access Trello in a new tab.

## Disconnecting Trello

<Steps>
  <Step title="Open Trello Settings">
    Go to **Settings > Integrations** and find the connected Trello card
  </Step>

  <Step title="Click Disconnect">
    Click the red **Disconnect** button
  </Step>

  <Step title="Confirm">
    Confirm that you want to disconnect
  </Step>
</Steps>

<Note>
  Disconnecting Trello removes Kasava's access to your Trello boards. Any linked cards will show as unlinked. Your Trello data is not deleted.
</Note>

## Use Cases

### Sprint Planning

Use Trello boards for sprint planning while linking cards to Kasava Plans for product context.

### Feature Request Tracking

Collect feature requests in Trello and link them to formal Plans when they're approved for development.

### Cross-Platform Visibility

Link a Trello board alongside GitHub repositories for complete visibility:

* Engineering work tracked in GitHub
* Design tasks managed in Trello
* Both visible and linked in Kasava Products

## Troubleshooting

<AccordionGroup>
  <Accordion title="Authorization failed or was denied">
    If the OAuth flow fails, you may have denied access or there was a network issue. Try the connection again from Settings > Integrations. Make sure you click "Allow" on the Trello authorization page.
  </Accordion>

  <Accordion title="No token found in callback">
    This error means the authorization was not completed. Try disconnecting (if partially connected) and reconnecting from scratch.
  </Accordion>

  <Accordion title="Connection test failed">
    Your Trello token may have expired or been revoked. Disconnect and reconnect the integration to get a fresh token.
  </Accordion>

  <Accordion title="Can't see my boards">
    Verify that the Trello account you connected has access to the boards you're trying to view. You may need to reconnect with a different Trello account.
  </Accordion>
</AccordionGroup>

## Permissions

Kasava requests these Trello permissions during authorization:

| Permission   | Purpose                                 |
| ------------ | --------------------------------------- |
| Read boards  | View board structure and metadata       |
| Read cards   | Access card details and content         |
| Write cards  | Create and update cards                 |
| Read members | Access user information for assignments |

## Security

* Authentication uses Trello's secure token flow
* Tokens are encrypted at rest
* No passwords are stored
* Disconnect anytime from Kasava or revoke access in Trello's settings

## Related

<CardGroup cols={2}>
  <Card title="Products" icon="layer-group" href="/docs/features/products">
    Link Trello to Products
  </Card>

  <Card title="Plans" icon="file-text" href="/docs/features/plans">
    Link cards to Plans
  </Card>

  <Card title="Asana Integration" icon="list-check" href="/docs/integrations/asana">
    Alternative: Connect Asana
  </Card>

  <Card title="Integrations Overview" icon="plug" href="/docs/integrations/overview">
    All available integrations
  </Card>
</CardGroup>