Trello Setup Guide

Open trello.com/power-ups/admin and sign in with your Trello account.

Fill in the form:

• Name: Flotify Feedback (or any name you like)
• Workspace: Select the workspace that contains your target board
• Iframe connector URL: Leave empty
• Email: Your email
• Author: Your name

After creating the Power-Up, you'll see your API Key on the left sidebar under "API Key". Copy it and save it somewhere safe.

TRELLO_API_KEY=your-api-key-here

On the same Power-Up page, next to your API Key, click the link "Token" (or you can generate one manually).

Replace YOUR_API_KEY in the URL below and open it in your browser:

https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&key=YOUR_API_KEY

Click "Allow". Trello will display your token. Copy it.

TRELLO_TOKEN=your-token-here

Navigate to the Trello board where you want feedback cards to land. Create a new list called Inbox (or use an existing one).

The easiest way to find your list ID is to open this URL in your browser (replace the values with yours):

https://api.trello.com/1/boards/YOUR_BOARD_ID/lists?key=YOUR_API_KEY&token=YOUR_TOKEN

To find your Board ID: open your board in Trello, add .json at the end of the URL, and look for the "id" field at the top of the JSON.

The API will return an array of lists. Find the one named "Inbox" and copy its id.

// Response example:
[
  {
    "id": "60d5f4b8c3a4e12a3f8b4567",  // <-- This is your List ID
    "name": "Inbox",
    ...
  },
  {
    "id": "60d5f4b8c3a4e12a3f8b4568",
    "name": "In Progress",
    ...
  }
]

TRELLO_LIST_ID=60d5f4b8c3a4e12a3f8b4567

Now that you have all three values, initialize the widget:

import { Flotify } from '@flotify/widget'

Flotify.init({
  provider: 'trello',
  trello: {
    apiKey: 'your-api-key',
    token: 'your-token',
    listId: 'your-list-id',
  },
})

// Submit a test feedback
Flotify.open()

Click the bubble, fill in a test feedback, and submit. Check your Trello board — a new card should appear in your Inbox list within seconds.

To get notified when new feedback arrives:

• Open your Trello board and find the Inbox list
• Click the "..." menu on the list header
• Click "Watch"

You'll now receive Trello notifications (email + mobile push) every time a user submits feedback. This is the fastest way to stay on top of incoming reports.