Skip to main content

​
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

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

​
2. Generate Token

  1. Visit: https://trello.com/1/authorize?expiration=never&name=Praxos&scope=read,write&response_type=token&key=YOUR_API_KEY
  2. Click “Allow”
  3. 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

​
Next Steps

Integration Overview

Tools Overview