Trello Integration

Overview

Trello integration enables Praxos to manage boards, lists, and cards in your Trello workspace.

Features

Create and update boards
Manage lists
Create, move, and update cards
Add comments and attachments
Manage labels and due dates
Add members to cards
Checklist management

Setup

1. Get API Credentials

Go to Trello Power-Ups Admin Portal
Click “New” to create a new Power-Up
Note your API Key

2. Generate Token

Visit: https://trello.com/1/authorize?expiration=never&name=Praxos&scope=read,write&response_type=token&key=YOUR_API_KEY
Click “Allow”
Copy the token

3. Configure Praxos

Add to .env:

TRELLO_API_KEY=your_api_key
TRELLO_TOKEN=your_token

Usage Examples

Board Management

List Boards

User: Show my Trello boards
Praxos: Your Trello boards:
         1. Product Roadmap
         2. Marketing Campaign
         3. Personal Tasks
         4. Team Goals Q4

Create Board

User: Create a Trello board called "New Project"
Praxos: ✓ Created board "New Project"
         Default lists: To Do, In Progress, Done
         [Open in Trello]

Card Operations

Create Card

User: Add a card "Design mockups" to my Product Roadmap board
Praxos: ✓ Created card in "Product Roadmap"
         List: To Do
         [View Card] [Add details]

Update Card

User: Move "Design mockups" to In Progress
Praxos: ✓ Moved card to "In Progress" list

Add Details

User: Add a due date of next Friday to the Design mockups card
Praxos: ✓ Updated card:
         Due date: Oct 15, 2024
         Reminder: 24 hours before

Comments and Activity

Add Comment

User: Comment on the Design mockups card: "Great progress!"
Praxos: ✓ Added comment to card
         Author: You
         Time: Just now

View Activity

User: What's the latest activity on the Product Roadmap board?
Praxos: Recent activity:
         • Sarah moved "API Integration" to Done (5 min ago)
         • Mike added checklist to "Testing" (1 hour ago)
         • You created "Design mockups" (2 hours ago)

Checklists

Create Checklist

User: Add a checklist to Design mockups card with 3 items:
      - Research competitors
      - Create wireframes
      - Get feedback
Praxos: ✓ Created checklist "Tasks" with 3 items
         Progress: 0/3 complete

Update Checklist

User: Mark "Research competitors" as complete
Praxos: ✓ Checked off item
         Progress: 1/3 complete (33%)

Labels

Add Label

User: Add "High Priority" label to Design mockups
Praxos: ✓ Added label "High Priority" (Red)

Filter by Label

User: Show all high priority cards in Product Roadmap
Praxos: High priority cards:
         1. Design mockups (To Do)
         2. User testing (In Progress)
         3. Launch preparation (To Do)

Configuration

Environment Variables

# Required
TRELLO_API_KEY=your_api_key
TRELLO_TOKEN=your_token

# Optional
TRELLO_DEFAULT_BOARD=board_id
TRELLO_WEBHOOK_CALLBACK=https://your-domain.com/trello/webhook

Board Templates

Configure default board structure:

DEFAULT_LISTS = ["To Do", "In Progress", "Review", "Done"]
DEFAULT_LABELS = ["High Priority", "Low Priority", "Bug", "Feature"]

Advanced Features

Webhooks

Real-time notifications for:

Card created/updated/moved
Comments added
Checklist items completed
Members added/removed

Setup webhook:

POST https://api.trello.com/1/tokens/{token}/webhooks/
{
  "callbackURL": "https://your-domain.com/trello/webhook",
  "idModel": "board_id"
}

Bulk Operations

User: Move all cards in "To Do" list that are due today to "In Progress"
Praxos: Moving 3 cards...
         ✓ Moved "Design mockups"
         ✓ Moved "Write documentation"
         ✓ Moved "Code review"

Card Templates

Create cards from templates:

User: Create a bug report card for "Login not working"
Praxos: ✓ Created bug report card:
         Title: [BUG] Login not working
         Checklist:
           - Reproduce issue
           - Identify root cause
           - Create fix
           - Test thoroughly
           - Deploy
         Labels: Bug, High Priority

Trello Power-Ups

Enhance with Power-Ups:

Calendar view
Custom fields
Card aging
Voting
Time tracking

Troubleshooting

Authentication Issues

Invalid Token

Token may have expired (if not set to “never”)
Regenerate token
Update .env file

Insufficient Permissions

Verify token has read/write scope
Check API key is valid
Ensure user has board access

Rate Limits

Trello rate limits:

100 requests per 10 seconds per token
300 requests per 10 seconds per API key

Praxos implements request queuing and automatic retry with backoff.

Board Not Found

Verify board ID is correct
Check user has access to board
Board may have been deleted or archived

Best Practices

Use clear, descriptive card titles
Leverage labels for categorization
Set due dates for time-sensitive tasks
Use checklists to break down complex tasks
Archive completed cards regularly
Maintain consistent board structure

Security

API keys and tokens encrypted
Per-user credential isolation
Secure webhook validation
Regular token rotation recommended

Integration with Other Tools

Combine Trello with other integrations:

User: Create a Trello card for every email from boss@company.com
Praxos: ✓ Created automation:
         New emails from boss@company.com →
         New cards in "Boss Requests" list

User: When I mark a Trello card as done,
      add it to my Notion "Completed Tasks" database
Praxos: ✓ Created automation:
         Trello card moved to Done →
         Entry added to Notion database

Getting Started

Web Application

Integrations

Tools & Capabilities

Deployment

Trello Integration

Overview

Features

Setup

1. Get API Credentials

2. Generate Token

3. Configure Praxos

Usage Examples

Board Management

Card Operations

Comments and Activity

Checklists

Labels

Configuration

Environment Variables

Board Templates

Advanced Features

Webhooks

Bulk Operations

Card Templates

Trello Power-Ups

Troubleshooting

Authentication Issues

Rate Limits

Board Not Found

Best Practices

Security

Integration with Other Tools

Next Steps

Integration Overview

Tools Overview

​Overview

​Features

​Setup

​1. Get API Credentials

​2. Generate Token

​3. Configure Praxos

​Usage Examples

​Board Management

​Card Operations

​Comments and Activity

​Checklists

​Labels

​Configuration

​Environment Variables

​Board Templates

​Advanced Features

​Webhooks

​Bulk Operations

​Card Templates

​Trello Power-Ups

​Troubleshooting

​Authentication Issues

​Rate Limits

​Board Not Found

​Best Practices

​Security

​Integration with Other Tools

​Next Steps

Integration Overview

Tools Overview

Overview

Features

Setup

1. Get API Credentials

2. Generate Token

3. Configure Praxos

Usage Examples

Board Management

Card Operations

Comments and Activity

Checklists

Labels

Configuration

Environment Variables

Board Templates

Advanced Features

Webhooks

Bulk Operations

Card Templates

Trello Power-Ups

Troubleshooting

Authentication Issues

Rate Limits

Board Not Found

Best Practices

Security

Integration with Other Tools

Next Steps