Enterprise Business Use Cases
Automated Support Queues
Route bug reports or feature requests directly into an “Inbox” List on your engineering team’s Trello Board, complete with the user’s uploaded screenshots.
Task Generation
When a new client completes an onboarding questionnaire, instantly generate a master Trello Card containing all their answers and place it in the “To Do” column for your project managers.
Ultra-Detailed, Step-by-Step Setup Guide
Connecting Flex Forms to Trello requires generating both an API Key and an Authorization Token. Trello’s security model requires you to generate these separately. Follow these exact instructions.1
Step 1: Log into Trello
Open your web browser and navigate to Trello. Enter your credentials and ensure you are logged into the account that has edit access to the Board you want to use.
2
Step 2: Access the Power-Ups Admin Portal
Open a new tab in your browser and navigate directly to this exact URL:
https://trello.com/power-ups/admin. This is the developer portal where you generate API credentials.3
Step 3: Create a New Integration
On the Power-Ups Admin page, click the blue button labeled New.A form will appear. Fill it out with the following exact details:
- Name:
Flex Forms Website Integration - Workspace: Select your company’s Trello Workspace from the dropdown.
- Email: Your administrator email address.
- Support Contact: Your email address again.
- Author: Your company name.
4
Step 4: Copy the API Key
You will be redirected to the API Keys page for your new integration.At the top, you will see a long string of alphanumeric characters labeled API Key. Highlight it, right-click, and select Copy.
5
Step 5: Inject the API Key into Flex Forms
Switch to your Flex Forms administrative dashboard in a new tab.
- Open Integrations (Flex Forms left rail) → Trello.
- Paste the string you copied in Step 4 into the API Key input field.
6
Step 6: Generate the Authorization Token
Switch back to the Trello tab. Look immediately to the right of your API Key. You will see a small text link that says Token (usually written as “generate a Token”). Click exactly on this link.
7
Step 7: Grant Access and Copy Token
A new window will open asking you to grant “Flex Forms Website Integration” access to your Trello account. Scroll to the bottom and click the green Allow button.Trello will now display a blank white page with a single, very long string of characters. This is your Authorization Token. Highlight the entire string and Copy it.
8
Step 8: Inject Token and Save
Switch back to Flex Forms. Paste this long string into the API Token input field. Click the Save Settings button to finalize the secure connection.
Masterclass: Routing Cards to Boards
Now that the connection is active, you must instruct Flex Forms exactly where to place the new Cards.List ID Requirement: You must provide the specific List ID in the form’s integration settings. A “List” is the vertical column (e.g., “To Do”, “Doing”) on a Trello Board.How to find the List ID:
- Open your Trello Board in a browser.
- Add
.jsonto the end of the URL (e.g.,trello.com/b/xyz/my-board.json) and press Enter. - Search the massive text wall (Ctrl+F) for the name of your List (e.g., “To Do”).
- Look for the
"id": "xxxxxxxxxxxxx"string immediately preceding the name of the list. Copy that alphanumeric ID.
Field Mapping Architecture
Trello is highly unstructured compared to a CRM. Every Card essentially has a Title and a Description. By default, Flex Forms intelligently compiles every single answer the user provided into a clean, markdown-formatted list and injects it into the Card Description.- Card Title Mapping
- Exact Mapping Example
You can map a specific form field to act as the primary Name (Title) of the Trello Card.The format is always:
name=flex_forms_block_namename field, Flex Forms will generate a generic title (e.g., “New Form Submission - [Date]”).
Troubleshooting & Enterprise FAQs
API Error: 401 invalid token
API Error: 401 invalid token
The Problem: The server logs show a
401 invalid token error when attempting to create a Card.The Solution: The Token you pasted in Step 8 has expired or was revoked. Trello sometimes requires you to re-authorize apps. Go back to Step 6, generate a brand new Token, and update Flex Forms.API Error: 400 invalid idList
API Error: 400 invalid idList
The Problem: The server logs show a
400 invalid idList error.The Solution: The List ID you pasted into the form settings is incorrect. Ensure you extracted the id of the actual List (column), NOT the id of the entire Board or the id of an individual Card.Configuration Reference
The following advanced settings are available in the Flex Forms UI for this integration. Use this reference to understand exactly how each field impacts the API payload.Global Settings
Located in Integrations in the Flex Forms left rail.password
required
Trello API Key
From https://trello.com/power-ups/admin
password
required
Trello Token
Form-Level Settings
Located on the form hub Integrations tab for a specific form.remote_select
required
Destination list
Board › list from boards you can access.
select
Card title field
Optional. Overrides the default title when the field has a value.
text
Default card title
Supports merge tags.
textarea
Card description template
Optional. Leave blank to send all fields as key: value lines. Supports .
text
Label IDs
Optional Trello label IDs for the new card.
text
Member IDs
Optional assignees.
select
Due date field
Optional. Value should parse as a date/time.
select
default:"top"
Card positionOptions:
top: Top of listbottom: Bottom of list