> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hotglue.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GitLab

# Connector Details

| Name        | Value                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| :---------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Platform    | [GitLab](https://gitlab.com)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Auth Type   | API Keys                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Direction   | Read                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Tap Repo    | [https://gitlab.com/hotglue/tap-gitlab](https://gitlab.com/hotglue/tap-gitlab)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Tap Metrics | <p>Usage: <Tooltip tip="low"><Icon icon="user" iconType="regular" color="#fff" size="14px" /><Icon icon="user" iconType="regular" color="#fff" size="14px" /><Icon icon="user" iconType="regular" color="#A9A9A9" size="14px" /><Icon icon="user" iconType="regular" color="#A9A9A9" size="14px" /></Tooltip><br />Success Rate: <Tooltip tip="medium"><Icon icon="circle-check" iconType="regular" color="#fff" size="14px" /><Icon icon="circle-check" iconType="regular" color="#fff" size="14px" /><Icon icon="circle-check" iconType="regular" color="#A9A9A9" size="14px" /><Icon icon="circle-check" iconType="regular" color="#A9A9A9" size="14px" /></Tooltip></p> |

# Credentials Setup

Follow the steps below to get the credentials you need to use the GitLab connector.

The first thing you must do is log in to your Gitlab account. If you have a Gitlab account, you can [login here](https://gitlab.com/users/sign_in?__cf_chl_jschl_tk__=MuF9GC0ejtTkFz20goTlkDJ.UzN8vbZBMo.6VsObMjw-1639681161-0-gaNycGzNCiU). If you do not have an account, you can create one [here](https://about.gitlab.com/pricing/).

## Gitlab API URL

Usually, you Gitlab API URL will be `https://gitlab.com/api/v4`

## Access Token

![](https://files.readme.io/69a5960-Screen_Shot_2021-12-16_at_2.22.37_PM.png "Screen Shot 2021-12-16 at 2.22.37 PM.png")

Now that you have logged in to Gitlab, your home page should look something like this. Go ahead to the top right corner and click the circular icon.

![](https://files.readme.io/5e1fb41-Screen_Shot_2021-12-16_at_2.26.27_PM.png "Screen Shot 2021-12-16 at 2.26.27 PM.png")

From the resulting drop down, you should click the **Edit Profile** option.

![](https://files.readme.io/641f83c-Screen_Shot_2021-12-16_at_2.43.47_PM.png "Screen Shot 2021-12-16 at 2.43.47 PM.png")

From this page, you should go ahead and select the **Access Tokens** tab.

![](https://files.readme.io/7323c80-Screen_Shot_2021-12-16_at_2.52.35_PM.png "Screen Shot 2021-12-16 at 2.52.35 PM.png")

You should now be on a page where you can create your own access token. Go ahead and title your access token "hotglue" and give it an expiration date.

Now we need to set the scopes for the access token. The gitlab tap expects the following scopes:

* `read_user`
* `read_api`
* `read_repository`
* `read_registry`

Once you are done selecting your scopes, go ahead and click the **Create personal access token**.

![](https://files.readme.io/30603ab-Screen_Shot_2021-12-16_at_3.11.03_PM.png "Screen Shot 2021-12-16 at 3.11.03 PM.png")

You now have your personal access token! Go ahead and copy it into hotglue.

## Your Groups (Optional)

![](https://files.readme.io/c383391-Screen_Shot_2021-12-16_at_3.17.39_PM.png "Screen Shot 2021-12-16 at 3.17.39 PM.png")

To find your groups, head to **Menu** option on the top left of the page.

![](https://files.readme.io/4abcdba-Screen_Shot_2021-12-16_at_3.18.29_PM.png "Screen Shot 2021-12-16 at 3.18.29 PM.png")

Then, you should navigate to the Groups tab, and within the Groups tab, head to the Your groups tab.

![](https://files.readme.io/67bfb86-Screen_Shot_2021-12-16_at_3.25.27_PM.png "Screen Shot 2021-12-16 at 3.25.27 PM.png")

I have a test group here titled **myawesometestgroup**. So in hotglue, I will put myawesometestgroup in the Groups entry.

## Your Projects

![](https://files.readme.io/8c44cdf-Screen_Shot_2021-12-16_at_3.30.43_PM.png "Screen Shot 2021-12-16 at 3.30.43 PM.png")

Using the menu, head to the Projects tab. You should then navigate to the Your projects.

![](https://files.readme.io/bdf9ae9-Screen_Shot_2021-12-16_at_3.37.19_PM.png "Screen Shot 2021-12-16 at 3.37.19 PM.png")

As you can see, I have a test project. In hotglue, I would input **myorg/myawesomeproject** into hotglue.
