How to Integrate Replit with Trello

1// trello-client.js — Node.js Trello API client
2const BASE_URL = 'https://api.trello.com/1';
3
4function getAuthParams() {
5  const key = process.env.TRELLO_API_KEY;
6  const token = process.env.TRELLO_TOKEN;
7  if (!key || !token) throw new Error('TRELLO_API_KEY and TRELLO_TOKEN secrets required');
8  return `key=${key}&token=${token}`;
9}
10
11async function trelloGet(endpoint) {
12  const url = `${BASE_URL}${endpoint}${endpoint.includes('?') ? '&' : '?'}${getAuthParams()}`;
13  const response = await fetch(url);
14  if (!response.ok) {
15    const error = await response.text();
16    throw new Error(`Trello API ${response.status}: ${error}`);
17  }
18  return response.json();
19}
20
21async function trelloPost(endpoint, body) {
22  const url = `${BASE_URL}${endpoint}?${getAuthParams()}`;
23  const response = await fetch(url, {
24    method: 'POST',
25    headers: { 'Content-Type': 'application/json' },
26    body: JSON.stringify(body)
27  });
28  if (!response.ok) {
29    const error = await response.text();
30    throw new Error(`Trello API ${response.status}: ${error}`);
31  }
32  return response.json();
33}
34
35async function trelloPut(endpoint, body) {
36  const url = `${BASE_URL}${endpoint}?${getAuthParams()}`;
37  const response = await fetch(url, {
38    method: 'PUT',
39    headers: { 'Content-Type': 'application/json' },
40    body: JSON.stringify(body)
41  });
42  if (!response.ok) {
43    const error = await response.text();
44    throw new Error(`Trello API ${response.status}: ${error}`);
45  }
46  return response.json();
47}
48
49// Get all boards for the authenticated user
50async function getBoards() {
51  return trelloGet('/members/me/boards?fields=id,name,url');
52}
53
54// Get all lists on a board
55async function getLists(boardId) {
56  return trelloGet(`/boards/${boardId}/lists?fields=id,name,pos`);
57}
58
59// Get all cards in a list
60async function getCards(listId) {
61  return trelloGet(`/lists/${listId}/cards?fields=id,name,desc,due,labels,url`);
62}
63
64module.exports = { trelloGet, trelloPost, trelloPut, getBoards, getLists, getCards };

1// server.js — Trello card management Express server
2const express = require('express');
3const { trelloPost, trelloPut, trelloGet, getBoards, getLists } = require('./trello-client');
4
5const app = express();
6app.use(express.json());
7
8// GET /boards — list all accessible boards
9app.get('/boards', async (req, res) => {
10  try {
11    const boards = await getBoards();
12    res.json({ boards });
13  } catch (err) {
14    res.status(500).json({ error: err.message });
15  }
16});
17
18// GET /boards/:boardId/lists — get lists on a board
19app.get('/boards/:boardId/lists', async (req, res) => {
20  try {
21    const lists = await getLists(req.params.boardId);
22    res.json({ lists });
23  } catch (err) {
24    res.status(500).json({ error: err.message });
25  }
26});
27
28// POST /cards — create a new card
29app.post('/cards', async (req, res) => {
30  try {
31    const { listId, name, description, dueDate, labelIds } = req.body;
32    if (!listId || !name) {
33      return res.status(400).json({ error: 'listId and name are required' });
34    }
35
36    const cardData = {
37      idList: listId,
38      name,
39      desc: description || '',
40      pos: 'bottom'
41    };
42
43    if (dueDate) cardData.due = dueDate; // ISO 8601 string
44    if (labelIds && labelIds.length > 0) {
45      cardData.idLabels = labelIds.join(',');
46    }
47
48    const card = await trelloPost('/cards', cardData);
49    res.json({
50      id: card.id,
51      name: card.name,
52      url: card.url,
53      shortLink: card.shortLink
54    });
55  } catch (err) {
56    res.status(500).json({ error: err.message });
57  }
58});
59
60// PUT /cards/:cardId/move — move card to a different list
61app.put('/cards/:cardId/move', async (req, res) => {
62  try {
63    const { targetListId } = req.body;
64    if (!targetListId) {
65      return res.status(400).json({ error: 'targetListId required' });
66    }
67
68    const updated = await trelloPut(`/cards/${req.params.cardId}`, {
69      idList: targetListId,
70      pos: 'bottom'
71    });
72    res.json({ success: true, cardId: updated.id, newList: updated.idList });
73  } catch (err) {
74    res.status(500).json({ error: err.message });
75  }
76});
77
78// PUT /cards/:cardId — update card details
79app.put('/cards/:cardId', async (req, res) => {
80  try {
81    const { name, description, dueComplete } = req.body;
82    const updates = {};
83    if (name) updates.name = name;
84    if (description !== undefined) updates.desc = description;
85    if (dueComplete !== undefined) updates.dueComplete = dueComplete;
86
87    const updated = await trelloPut(`/cards/${req.params.cardId}`, updates);
88    res.json({ success: true, card: { id: updated.id, name: updated.name } });
89  } catch (err) {
90    res.status(500).json({ error: err.message });
91  }
92});
93
94app.listen(3000, '0.0.0.0', () => {
95  console.log('Trello integration server running on port 3000');
96});

1# trello_webhook.py — Python webhook registration and handler
2import os
3import requests
4from flask import Flask, request, jsonify
5
6app = Flask(__name__)
7
8TRELLO_BASE = 'https://api.trello.com/1'
9
10def get_auth_params():
11    return {
12        'key': os.environ['TRELLO_API_KEY'],
13        'token': os.environ['TRELLO_TOKEN']
14    }
15
16def register_webhook(model_id, callback_url):
17    """Register a Trello webhook for a board or card ID."""
18    params = {**get_auth_params(),
19              'idModel': model_id,
20              'callbackURL': callback_url,
21              'description': 'Replit Integration Webhook'}
22    response = requests.post(f'{TRELLO_BASE}/webhooks', params=params)
23    response.raise_for_status()
24    return response.json()
25
26def list_webhooks():
27    """List all webhooks for the current token."""
28    params = get_auth_params()
29    response = requests.get(
30        f'{TRELLO_BASE}/tokens/{params["token"]}/webhooks',
31        params=params
32    )
33    return response.json()
34
35# Trello sends HEAD request to verify webhook URL — must return 200
36@app.route('/trello-webhook', methods=['HEAD'])
37def webhook_verify():
38    return '', 200
39
40# Handle incoming webhook events
41@app.route('/trello-webhook', methods=['POST'])
42def trello_webhook():
43    payload = request.json
44    if not payload:
45        return 'OK', 200
46
47    action = payload.get('action', {})
48    action_type = action.get('type', 'unknown')
49    data = action.get('data', {})
50
51    print(f'Trello event: {action_type}')
52
53    if action_type == 'createCard':
54        card_name = data.get('card', {}).get('name')
55        list_name = data.get('list', {}).get('name')
56        print(f'New card created: "{card_name}" in "{list_name}"')
57
58    elif action_type == 'updateCard':
59        card = data.get('card', {})
60        old = data.get('old', {})
61        if 'idList' in old:
62            # Card was moved between lists
63            print(f'Card moved: {card.get("name")} -> list {card.get("idList")}')
64        elif 'dueComplete' in old:
65            complete = card.get('dueComplete')
66            print(f'Card completion changed: {card.get("name")} -> {complete}')
67
68    elif action_type == 'commentCard':
69        text = data.get('text', '')
70        member = action.get('memberCreator', {}).get('fullName', 'Unknown')
71        print(f'Comment by {member}: {text[:100]}')
72
73    return 'OK', 200
74
75@app.route('/register-webhook', methods=['POST'])
76def create_webhook():
77    """Endpoint to register a new Trello webhook."""
78    data = request.json
79    board_id = data.get('boardId')
80    callback_url = data.get('callbackUrl')
81
82    if not board_id or not callback_url:
83        return jsonify({'error': 'boardId and callbackUrl required'}), 400
84
85    webhook = register_webhook(board_id, callback_url)
86    return jsonify({'webhook': webhook})
87
88if __name__ == '__main__':
89    app.run(host='0.0.0.0', port=3000)