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

# GitLab Provider

> GitLab provider is a provider used for creating issues in GitLab

## Authentication

This provider requires authentication.

* **host**: GitLab Host (required: True, sensitive: False)
* **personal\_access\_token**: GitLab Personal Access Token (required: True, sensitive: True)

Certain scopes may be required to perform specific actions or queries via the provider. Below is a summary of relevant scopes and their use cases:

* **api**: Authenticated with api scope (mandatory)

## In workflows

This provider can be used in workflows.

As "action" to make changes or update data, example:

```yaml theme={null}
actions:
    - name: Query gitlab
      provider: gitlab
      config: "{{ provider.my_provider_name }}"
      with:
        id: {value}  
        title: {value}  
        description: {value}  
        labels: {value}  
        issue_type: {value}  
```

If you need workflow examples with this provider, please raise a [GitHub issue](https://github.com/keephq/keep/issues).

## Connecting with the Provider

1. Go to [Personal Access Token](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html#create-a-personal-access-token) to see how to create a personal\_access\_token.
2. Get `host`, eg: if you're using Cloud GitLab, use: `https://gitlab.com` or use your `host` if you're using onPrem.

## Useful Links

* [GitLab PAT](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html#create-a-personal-access-token)
* [GitLab Create New Issue](https://docs.gitlab.com/ee/api/issues.html#new-issue)
* [GitLab Scopes](https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html#personal-access-token-scopes)