It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Cloud REST API authentication with API key

I'm trying to use Postman to access our cloud instance via REST. I clicked the "Run in Postman" button in the API docs, and it did import a collection into Postman. But in the auth, folder, the Create Session request continually returns 401. When I open the notes at the top, there's a link indicating that that particular endpoint was deprecated last year, with a link to this document.

So, if the only endpoint provided in the collection doesn't actually exist anymore, how do I authenticate via Postman using an API token? I think I can add a new request, but what should the endpoint be?

I'd love it if there were a video out there somewhere, but most of what I've found on YouTube is old enough to be out of date.

2 answers

0 votes
Marty Atlassian Team Feb 14, 2019

Hi Esther,

I'm not part of the Jira or Confluence team, but I'll see if I can help.

You can still use Postman to test some endpoints (curl is another alternative that is not too much of a pain to learn).

I *think* the key difference is that you need to send an Authorization header with an API token instead of with a user password.  So if you setup an API token in your instance, then you can go to your Postman request and change the 'password' being using in the Authorization header.  I think the header is 'user:api_token'.

I hope that helps!

Thanks, I'll give that a shot. I'm new to Postman as well, so I'm not sure how much of the problem is setup vs actual API.

Was there any update to this?  Since basic authentication was deprecated on June 5th I've run into issues (Auth deprecation).  I can create an API-Token but I don't know how to feed it into Postman in a way that works.  Simply putting the api-token as the password for basic authentication doesn't work.

Hi @Esther Strom@Jamie  - in Postman Authorization, use Basic Auth.  For username, use your email address.  For the Password, use the API Token you generated from


Let me know if that worked for you.

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Jira

The add-in you’ve been waiting for: Jira Cloud for Excel 🙌

Introducing Jira Cloud for Excel Here at the product integrations team at Atlassian, we are thrilled to announce the new Jira Cloud for Excel add-in! This add-in lets you export Jira data directly ...

841 views 5 22
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you