How to pass scope value while reading Hipchat room history via API?



Im struggling with reading room history, from my Python script and keep getting:


"error": {
"code": 403,
"message": "This action requires one of the following scopes: [u'view_messages']",
"type": "Forbidden"


Im not sure how to pass scope value in my request.

Tried various methods, none of them works.

My script


#!/usr/bin/env python

import jsonimport requests

headers = { 'Content-Type' : 'application/json' }

capabilities={ "hipchatApiConsumer": { "scopes": ["view_messages"] } }

params={ 'auth_token' : 'ABC, 'capabilities': capabilities }

req=requests.get('', headers=headers, params=params)

print req.content



1 answer

This widget could not be displayed.

Hi, Lukasz!

Make sure the scope is enabled in the capabilities descriptor as explained in the following article:


Let us know in case of any obstacles!

Suggest an answer

Log in or Sign up to answer
Atlassian Summit 2018

Meet the community IRL

Atlassian Summit is an excellent opportunity for in-person support, training, and networking.

Learn more
Community showcase
Published Aug 10, 2018 in Hipchat

What should I think about when migrating HipChat to Slack?

...from the beginning. We have built up a lot of content in HipChat, with it being a core tool in our distributed company model. While it is true that we didn’t need to move to Slack immediately, we felt it...

241 views 1 9
Read article

Atlassian User Groups

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

Find a group

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

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you