2017-07-20 15:29:42 +00:00
# Trello Power-Up
2017-07-20 22:24:23 +00:00
GitLab's Trello Power-Up enables you to seamlessly attach
GitLab **merge requests** to Trello cards.
2017-07-20 15:29:42 +00:00
2017-07-20 22:53:37 +00:00
![GitLab Trello PowerUp - Trello card ](img/trello_card_with_gitlab_powerup.png )
2017-07-20 15:29:42 +00:00
## Configuring the Power-Up
In order to get started, you will need to configure your Power-Up.
2017-07-20 22:24:23 +00:00
In Trello:
2017-07-20 15:29:42 +00:00
2017-07-20 22:24:23 +00:00
1. Go to your Trello board
2017-07-20 15:29:42 +00:00
1. Select `Power-Ups` to see a listing of all the available Power-Ups
1. Look for a row that says `GitLab` and select the `Enable` button
1. Select the `Settings` (gear) icon
1. In the popup menu, select `Authorize Account`
In this popup, fill in your `API URL` and `Personal Access Token` . After that, you will be able to attach any merge request to any Trello card on your selected Trello board.
## What is my API URL?
2017-07-20 22:24:23 +00:00
Your API URL should be your GitLab instance URL with `/api/v4` appended in the end of the URL.
For example, if your GitLab instance URL is `https://gitlab.com` , your API URL would be `https://gitlab.com/api/v4` .
If your instance's URL is `https://example.com` , your API URL will be `https://example.com/api/v4` .
2017-07-20 15:29:42 +00:00
2017-07-20 22:53:37 +00:00
![configure GitLab Trello PowerUp in Trello ](img/enable_trello_powerup.png )
2017-07-20 15:29:42 +00:00
## What is my Personal Access Token?
2017-07-20 22:24:23 +00:00
Your GitLab's personal access token will enable your GitLab account to be accessed
from Trello.
> Find it in GitLab by clicking on your avatar (upright corner), from which you access
your user **Settings** > **Access Tokens** .
Learn more about generating a personal access token in the
[Personal Access Token Documentation][personal-access-token-documentation].
Don't forget to check the API scope checkbox!
2017-07-20 15:29:42 +00:00
2017-07-20 21:04:39 +00:00
[personal-access-token-documentation]: ../user/profile/personal_access_tokens.html