info: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
---
# Create an API token in Jira on Atlassian cloud **(FREE)**
For [integrations with Jira](../../user/project/integrations/jira.md), an API token is needed when integrating with Jira
on Atlassian cloud. To create an API token:
1. Log in to [`id.atlassian.com`](https://id.atlassian.com/manage-profile/security/api-tokens) with your email address.
NOTE:
It is important that the user associated with this email address has *write* access
to projects in Jira.
1. Click **Create API token**.
1. Click **Copy**, or click **View** and write down the new API token. It is required when [configuring GitLab](../../user/project/integrations/jira.md#configure-gitlab).
The Jira configuration is complete. You need the newly created token, and the associated email
address, when [configuring GitLab](../../user/project/integrations/jira.md#configure-gitlab).
info: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
---
# Create Jira Server username and password **(FREE)**
For [integrations with Jira](../../user/project/integrations/jira.md), you must create a user account in Jira to have access to
all projects that need to integrate with GitLab.
The Jira user account created for the integration must have write access to
your Jira projects.
As an example, the following process creates a user named `gitlab` and that's a
member of a new group named `gitlab-developers`:
1. Sign in to your Jira instance as an administrator, and
then go to the gear icon and select **User Management**.
1. Create a new user account (for example, `gitlab`) with write access to
projects in Jira. Enter the user account's name and a valid e-mail address,
because Jira sends a verification email to set up the password.
Jira creates the username by using the email prefix. You can change the
username later, if needed. The GitLab integration doesn't support SSO (such
as SAML). You need to create an HTTP basic authentication password. You can
do this by visiting the user profile, looking up the username, and setting a
password.
1. From the sidebar, select **Groups**.
1. In the **Add group** section, enter a **Name** for the group (for example,
`gitlab-developers`), and then select **Add group**.
1. Add the `gitlab` user to the `gitlab-developers` group by selecting **Edit members**.
The `gitlab-developers` group should be listed in the leftmost box as a
selected group. In the **Add members to selected group(s)** area, enter `gitlab`.
Select **Add selected users**, and `gitlab` should appear in the **Group member(s)**
area. This membership is saved automatically.
1. To give the newly-created group 'write' access, you must create a permission
scheme. To do this, in the admin menu, go to the gear icon and select **Issues**.
1. From the sidebar, select **Permission Schemes**.
1. Select **Add Permission Scheme**, enter a **Name** and (optionally) a
**Description**, and then select **Add**.
1. In the permissions scheme list, locate your new permissions scheme, and
select **Permissions**. Next to **Administer Projects**, select **Edit**. In
the **Group** list, select `gitlab-developers`.
The Jira configuration is complete. Write down the new Jira username and its
password, as you need them when [configuring GitLab](../../user/project/integrations/jira.md#configure-gitlab).
info: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
---
---
# Create an API token in Jira on Atlassian cloud **(FREE)**
This document was moved to [another location](../../../integration/jira/jira_cloud_configuration.md).
For [integrations with Jira](jira.md), an API token is needed when integrating with Jira
<!-- This redirect file can be deleted after <2021-06-18>. -->
on Atlassian cloud. To create an API token:
<!-- Before deletion, see: https://docs.gitlab.com/ee/development/documentation/#move-or-rename-a-page -->
1. Log in to [`id.atlassian.com`](https://id.atlassian.com/manage-profile/security/api-tokens) with your email address.
NOTE:
It is important that the user associated with this email address has *write* access
to projects in Jira.
1. Click **Create API token**.
1. Click **Copy**, or click **View** and write down the new API token. It is required when [configuring GitLab](jira.md#configure-gitlab).
The Jira configuration is complete. You need the newly created token, and the associated email
address, when [configuring GitLab](jira.md#configure-gitlab).
info: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
---
---
# Create Jira Server username and password **(FREE)**
This document was moved to [another location](../../../integration/jira/jira_server_configuration.md).
For [integrations with Jira](jira.md), you must create a user account in Jira to have access to
<!-- This redirect file can be deleted after <2021-06-18>. -->
all projects that need to integrate with GitLab.
<!-- Before deletion, see: https://docs.gitlab.com/ee/development/documentation/#move-or-rename-a-page -->
The Jira user account created for the integration must have write access to
your Jira projects.
As an example, the following process creates a user named `gitlab` and that's a
member of a new group named `gitlab-developers`:
1. Sign in to your Jira instance as an administrator, and
then go to the gear icon and select **User Management**.
1. Create a new user account (for example, `gitlab`) with write access to
projects in Jira. Enter the user account's name and a valid e-mail address,
because Jira sends a verification email to set up the password.
Jira creates the username by using the email prefix. You can change the
username later, if needed. The GitLab integration doesn't support SSO (such
as SAML). You need to create an HTTP basic authentication password. You can
do this by visiting the user profile, looking up the username, and setting a
password.
1. From the sidebar, select **Groups**.
1. In the **Add group** section, enter a **Name** for the group (for example,
`gitlab-developers`), and then select **Add group**.
1. Add the `gitlab` user to the `gitlab-developers` group by selecting **Edit members**.
The `gitlab-developers` group should be listed in the leftmost box as a
selected group. In the **Add members to selected group(s)** area, enter `gitlab`.
Select **Add selected users**, and `gitlab` should appear in the **Group member(s)**
area. This membership is saved automatically.
1. To give the newly-created group 'write' access, you must create a permission
scheme. To do this, in the admin menu, go to the gear icon and select **Issues**.
1. From the sidebar, select **Permission Schemes**.
1. Select **Add Permission Scheme**, enter a **Name** and (optionally) a
**Description**, and then select **Add**.
1. In the permissions scheme list, locate your new permissions scheme, and
select **Permissions**. Next to **Administer Projects**, select **Edit**. In
the **Group** list, select `gitlab-developers`.
The Jira configuration is complete. Write down the new Jira username and its
password, as you need them when [configuring GitLab](jira.md#configure-gitlab).
