gitlab-org--gitlab-foss/doc/integration/trello_power_up.md

1.8 KiB

stage group info
Create Ecosystem To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments

Trello Power-Up

The GitLab Trello Power-Up enables you to seamlessly attach GitLab merge requests to Trello cards.

GitLab Trello PowerUp - Trello card

Configuring the Power-Up

In order to get started, you must configure your Power-Up.

In Trello:

  1. Go to your Trello board
  2. Select Power-Ups to see a listing of all the available Power-Ups
  3. Look for a row that says GitLab and select the Enable button
  4. Select the Settings (gear) icon
  5. In the popup menu, select Authorize Account

In this popup, fill in your API URL and Personal Access Token. After that, you can attach any merge request to any Trello card on your selected Trello board.

What is my API URL?

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 is https://example.com/api/v4.

configure GitLab Trello PowerUp in Trello

What is my Personal Access Token?

Your GitLab personal access token enables 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. Don't forget to check the API scope checkbox!