Trello Connector

Manage boards, cards, lists, and checklists in Trello

Trello Connector

Automate your task management with Trello. Create and move cards, organize lists, add checklists, and keep your team on track—all from DeepChain.

Overview

The Trello connector provides 17 operations for managing your Trello boards. Whether you're a team tracking tasks or an agile squad managing sprints, this connector makes it easy.

Authentication

Trello uses API Key + Token authentication:

auth_type: api_key
api_key: "your-api-key"
token: "your-oauth-token"

How to get them:

  1. Go to trello.com/app-key
  2. Copy your API Key
  3. Click Token link and authorize to get your Token
  4. Paste both into DeepChain credentials

Available Operations

Operation What It Does
getBoard Fetch board details
createBoard Create new board
listBoards List member's boards
getList Fetch list details
createList Create list on board
getCard Fetch card details
createCard Create card on list
updateCard Update card details
deleteCard Delete card
moveCard Move card to different list
addComment Add comment to card
addMember Add member to card
addLabel Add label to card
addChecklist Add checklist to card
getMembers List board members
getLabels List board labels
getChecklists Get card checklists

Practical Workflow Examples

Example 1: Create Card from Web Form

Turn web submissions into Trello cards:

- id: create_task
  type: trello_connector
  config:
    operation: createCard
    idList: "{{ input.list_id }}"
    name: "{{ input.task_title }}"
    desc: "{{ input.description }}"
    due: "{{ formatDate(input.due_date, 'x') }}/1000"  # Unix timestamp in seconds
    idLabels:
      - "{{ input.label_id }}"

Example 2: Move Card to "Done"

Automatically complete tasks:

- id: move_to_done
  type: trello_connector
  config:
    operation: moveCard
    idCard: "{{ input.card_id }}"
    idList: "{{ input.done_list_id }}"

Example 3: Add Checklist and Items

Create a subtask checklist:

- id: add_checklist
  type: trello_connector
  config:
    operation: addChecklist
    idCard: "{{ input.card_id }}"
    name: "Checklist"
    idChecklistSource: "{{ input.template_checklist_id }}"  # Copy from template

Example 4: Add Members and Labels

Assign work and categorize:

- id: assign_and_label
  type: trello_connector
  config:
    operation: addMember
    idCard: "{{ input.card_id }}"
    idMember: "{{ input.member_id }}"

- id: add_label
  type: trello_connector
  config:
    operation: addLabel
    idCard: "{{ input.card_id }}"
    idLabel: "{{ input.label_id }}"  # e.g., "bug", "feature", "urgent"

Example 5: Add Comment with Update

Update stakeholders:

- id: add_comment
  type: trello_connector
  config:
    operation: addComment
    idCard: "{{ input.card_id }}"
    text: |
      Progress Update:
      • Status: {{ input.status }}
      • Next: {{ input.next_steps }}
      Updated by: {{ input.updated_by }}

Best Practices

1. Store List and Board IDs

Keep commonly used IDs in variables:

# Use environment variables or input
list_id: "{{ credentials.trello.done_list_id }}"
board_id: "{{ credentials.trello.main_board_id }}"

2. Use Labels for Categories

Create labels for filtering:

idLabels:
  - "{{ input.priority_label }}"  # "urgent", "normal", "low"
  - "{{ input.type_label }}"      # "bug", "feature", "docs"

3. Set Due Dates Correctly

Dates must be Unix timestamps in seconds:

due: "{{ formatDate(input.due_date, 'x') }}/1000"

4. Create Cards with Full Details

Add description, due dates, and labels upfront:

- id: create_complete_card
  type: trello_connector
  config:
    operation: createCard
    idList: "{{ input.list_id }}"
    name: "{{ input.title }}"
    desc: "{{ input.description }}"
    due: "{{ formatDate(input.due, 'x') }}/1000"
    idLabels:
      - "{{ input.label_id }}"
    pos: "top"  # Or "bottom"

5. Template Checklists

Reuse checklists from templates instead of recreating them:

- id: add_checklist_from_template
  type: trello_connector
  config:
    operation: addChecklist
    idCard: "{{ input.card_id }}"
    name: "Quality Assurance"
    idChecklistSource: "{{ input.qa_checklist_template_id }}"

Rate Limits

Trello enforces per-token rate limits:

  • API Key: 100 requests per 10 seconds
  • OAuth Token: 300 requests per 10 seconds

Note: DeepChain handles rate limiting with backoff.

Error Handling

Error What It Means How to Fix
invalid_request Malformed request Check card ID, list ID format
unauthorized Bad API key/token Re-authenticate
not_found Card, list, or board doesn't exist Verify IDs

Next Steps