Skip to content

How to create a Jira API token

Updated 13 October 2026 · 2 min read

Tools and scripts that talk to Jira Cloud on your behalf sign in with your Atlassian email address and an API token instead of your password. Creating one takes about two minutes.

What a Jira API token is

An API token is a long, random password that belongs to your Atlassian account and is meant for software, not people. A tool signs in with your email address as the username and the token as the password, and can then do whatever you are allowed to do in Jira.

Unlike your real password, a token can be revoked on its own at any time, without affecting how you sign in yourself — so give every tool its own token.

Create the token

  1. Sign in to your Atlassian account and open id.atlassian.com → Security → API tokens.
  2. Click Create API token.
  3. Give it a name that tells you later where it is used, for example IssueRadar – MacBook.
  4. Choose when it should expire, if you are asked. Atlassian tokens have an expiry date — note it in your calendar.
  5. Click Create and copy the token straight away. Atlassian shows it only once; if you lose it, create a new one.

Atlassian also offers tokens with scopes. Those are for apps that call Atlassian’s API gateway. A tool that asks for your site address, email and token — like IssueRadar — expects the regular token without scopes.

Use it

Wherever a tool asks for a Jira login, enter:

  • Site: your Jira address, such as https://your-company.atlassian.net
  • Email: the address you sign in to Atlassian with
  • Token: the token you just copied

To check that a token works, you can ask Jira who you are from Terminal:

curl -u you@company.com:YOUR_TOKEN \\n  https://your-company.atlassian.net/rest/api/3/myself

A JSON reply with your name means the token is valid.

Keep it safe

  • Treat the token like a password: never paste it into chats, tickets or emails, and don’t commit it to a repository.
  • Store it in a password manager or the macOS Keychain — IssueRadar keeps its tokens in the Keychain only.
  • Revoke tokens you no longer use on the same API tokens page.

When the token expires

After the expiry date, requests with the token are refused. Create a new token the same way and replace the old one in every tool that used it. In IssueRadar, a failed check is shown in the menu with the connection’s name; open Settings → Connections, select the connection, click Edit… and paste the new token.

Questions and answers