doc/user/project/integrations/jira_cloud_configuration.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

---
stage: Create
group: Ecosystem
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
---

# Creating an API token in Jira Cloud

An API token is needed when integrating with Jira Cloud, follow the steps
below to create one:

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**.

![Jira API token](img/jira_api_token_menu.png)

![Jira API token](img/jira_api_token.png)

1. Click **Copy**, or click **View** and write down the new API token. It is required when [configuring GitLab](jira.md#configuring-gitlab).

The Jira configuration is complete. You need the newly created token, and the associated email address, when [configuring GitLab](jira.md#configuring-gitlab) in the next section.