> For the complete documentation index, see [llms.txt](https://docs.getmesa.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getmesa.com/connect/trello.md).

# Trello

## Connection

When you're setting up your first workflow with Trello, you'll need to [connect](https://docs.getmesa.com/going-further/credentials) MESA with Trello.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fgit-blob-2c97a980de047d724ece36f192585ce26b7af478%2Fimage%20(2)%20(1)%20(1).png?alt=media" alt="Screenshot of the MESA workflow builder Trello step connection setup, connecting MESA with Trello. Spotlight the connection fields."><figcaption></figcaption></figure>

1. Login to your Trello account at [https://trello.com](https://trello.com/)
2. Navigate to <https://trello.com/power-ups/admin/> and click "New"

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fgit-blob-e1717513d5bed16045aa4461f6a58f81e6a58a85%2Fimage%20(1)%20(1)%20(1)%20(1)%20(1).png?alt=media" alt="Screenshot of the Trello Power-Ups admin page, click New to create a new integration. Spotlight the New button."><figcaption></figcaption></figure>

3. Name the integration MESA, choose a Trello workspace, complete the additional fields, and click Create.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fgit-blob-e132217f923f8820cfdcf8ee432e4c3d82a773e0%2Fimage%20(2)%20(1)%20(1)%20(1).png?alt=media" alt="Screenshot of the Trello new Power-Up form, naming the integration MESA and choosing a workspace. Spotlight the Create button."><figcaption></figcaption></figure>

4. Click on API key and click Generate a new API key.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fgit-blob-bde1b3e5bca69d4fb4901e918ce71e822cb31fd6%2Fimage%20(3)%20(1)%20(1).png?alt=media" alt="Screenshot of the Trello Power-Up API key page, click Generate a new API key. Spotlight the Generate a new API key button."><figcaption></figcaption></figure>

5. Copy your API Key and paste it into the API key field of your MESA workflow's Trello step.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fgit-blob-a669cfdfecfcd12ecc810fe8011e6fff49fb3d70%2Fimage%20(4)%20(1)%20(1).png?alt=media" alt="Screenshot of the MESA workflow Trello step, pasting the copied API Key into the API key field. Spotlight the API key field."><figcaption></figcaption></figure>

6. Click on the Token link next to the API key in Trello to generate a token.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fgit-blob-908b997d6b9331e089300aaba759a2d32a55161c%2Fimage%20(5)%20(1).png?alt=media" alt="Screenshot of the Trello Power-Up API key page, click the Token link next to the API key to generate a token. Spotlight the Token link."><figcaption></figcaption></figure>

7. On the authorization page, scroll down and click ALLOW.
8. Copy the token and paste it into the API Token field of your MESA workflow's Trello step.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fgit-blob-71d9fcfc63e18ea09843098fc7eed85aa7f7b55d%2Fimage%20(6)%20(1).png?alt=media" alt="Screenshot of the MESA workflow Trello step, pasting the copied token into the API Token field. Spotlight the API Token field."><figcaption></figcaption></figure>

9. With both the API Key and API Token fields filled out, click the Add connection button to complete the connection.

<figure><img src="https://3425906282-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1H6u1HQc3Iew7ATmmiCi%2Fuploads%2Fgit-blob-6591e18f2ecb0890d109500e748231956e4c7a6e%2Fimage%20(7).png?alt=media" alt="Screenshot of the MESA workflow Trello step with the API Key and API Token filled in, click Add connection to complete the connection. Spotlight the Add connection button."><figcaption></figcaption></figure>
