Work management
Trello
Sync Trello boards, lists, and cards with Atlas so visual planning stays connected to operational records.
What this connector does
- Sync Trello boards, lists, and cards into Atlas project views.
- Reflect card movement and label changes across both systems.
- Convert cards into Atlas tasks with linked checklists.
- Listen for Trello webhook events.
Before you begin
- You are an admin of the Trello Workspace.
- API key access is allowed.
- You have a sandbox board to validate the first sync.
Get your credentials
Open the Trello power-ups admin
Sign in with the workspace admin. trello.com/power-ups/admin
Create a power-up
Click New, name it Atlas Connector, and pick the workspace.
Generate an API key
Open the API key tab and click Generate a new API key.
Add the Atlas callback URL
Add https://YOUR-ATLAS-HOST/oauth/callback/trello to the allowed Origins.
Copy the API key and secret
Copy API Key and Secret into the Atlas Trello connector settings page. The OAuth flow returns a per-user token.
Required scopes and permissions
readwriteaccountSetup checklist
- Create the provider app in a sandbox or development workspace.
- Add the Atlas redirect URL to the provider app configuration.
- Copy the client id, client secret, or API key.
- Paste the credentials into the Atlas connector settings page.
- Click Connect and complete the provider sign-in screen.
- Run Test connection from the connector page to verify health.
Troubleshooting
invalid token
The per-user token was revoked. Reconnect from Atlas.
invalid origin
Add the Atlas hostname to Allowed Origins in the power-up settings.
webhook 410 deleted
Trello deletes webhooks whose callbacks return non-2xx for several days. Recreate the connection.
Webhooks
Atlas registers Trello webhooks per board and validates the X-Trello-Webhook signature header.
Events Atlas listens for
- createCard
- updateCard
- commentCard
- addLabelToCard
Provider docs: https://developer.atlassian.com/cloud/trello/guides/rest-api/webhooks/
Disconnect and data deletion
- Click Disconnect on the Atlas Trello connector page.
- Open https://trello.com/your/account, Other applications and revoke Atlas Connector.
- Atlas removes cached board data within 24 hours of disconnect.
Once you have the credentials above, paste them into the live connector page to finish connecting Trello.
Open the Trello connector page