How can my application send notifications to HipChat using an addon?

I am attempting to setup a simple addon to allow my application to send notifications to HipChat rooms.

I used the BYO integration for my first attempt. This worked great as it supplied me an apitoken my application can use when communicating with the HipChat rest api. The problem is I cannot seem to install this same BYO integration in multiple rooms.

My second attempt involved creating an addon to be installed by descriptor url. I have been able to install this in multiple rooms, but I do not see the apitoken to use.

How can I get an apitoken for my addon like the BYO integration addon? Is there a sample available, or a way to view the addon code for the BYO integration?

This is what my capabilities section looks like:

"capabilities": {
    "hipchatApiConsumer": {
      "fromName": "Build Notification",
      "scopes": [
    "installable": {
      "allowGlobal": true,
      "allowRoom": true
    "oauth2Provider": {
      "authorizationUrl": "",
      "tokenUrl": ""

1 answer

1 vote

To get an OAuth access token so you can call the HipChat api, you actually have to generate one after you've received the oauth_id and secret at install time (this is posted to your installable.callbackUrl – which looks like is missing in your descriptor). The details are available here:

If you're using our nodejs framework for building an addon, the access token generation is handled for you automatically. I whipped up a simple add-on on HyperDev yesterday. Feel free to remix and test out on your own:!/project/walnut-braid

Suggest an answer

Log in or Sign up to answer
How to earn badges on the Atlassian Community

How to earn badges on the Atlassian Community

Badges are a great way to show off community activity, whether you’re a newbie or a Champion.

Learn more
Community showcase
Published Mar 26, 2018 in Hipchat Data Center

Migration of Hipchat server to Data Center - a retrospective

Background While our Hipchat server environment was reliable and performing well, as a significant and growing part of our business, the need to leverage the benefits of Hipchat Data Center&nbs...

522 views 2 7
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