HipChat: Installing unlisted/private webhook


I am attempting to develop a HipChat webhook. I am at the point where I am ready to test the webhook, but I can't seem to install it successfully in our HipChat Cloud instance.

My process is as follows:

  1. Log into the HipChat web app (https://<hipchatname>.hipchat.com) as a group admin.
  2. Click the "Integrations" link at the top (https://<hipchatname>.hipchat.com/addons)
  3. Click the "Install an integration from a descriptor URL" link at the bottom of the page
  4. Enter the URL to the capabilities descriptor endpoint in my website. (I have verified that this endpoint exists, is publicly accessible, and returns a capabilities document that is valid according to the validator.)
  5. Select the room I want to install the add-on for.
  6. The Add-on Overview page shows up, with the correct Name and Description listed. However, clicking the "Add Integration" button does not do anything, and if I open the Chrome console, the following XHR requests have been made but have resulted in a 404:

    https://marketplace.atlassian.com/rest/2.0-beta/addons/<addon key>/versions/latest?host=<hipchatname>.hipchat.com&application=hipchat
    https://marketplace.atlassian.com/rest/2.0-beta/addons/<addon key>?host=<hipchatname>.hipchat.com&application=HipChat

I also tried adding my integration to the Atlassian Marketplace as a private add-on, but trying to install it using that capabilities descriptor (or the link given on the add-on's "Installation" page) results in the same behavior. I have checked my web application's logs and the URL specified in the capabilities descriptor's "callbackUrl" property is never accessed.

How do I go about successfully installing an unlisted/private webhook to a room for testing/debugging purposes?



1 answer

1 accepted

0 vote

Hi Eric,

You should be able to install an integration via a descriptor URL even if it is not listed on Atlassian Marketplace. Could you please give us the URL of your add-on and we will try to debug what's going wrong?

Is there an email address I can send the URL to? I'd prefer not to post it publicly.


integrations@hipchat.com – that's our mailing list that addon vendors can mail to ask questions (only Atlassian guys are on the list).

The issue turned out to be an error on Atlassian's side which is now resolved. Thanks!

Suggest an answer

Log in or Join to answer
Community showcase
Maarten Cautreels
Published Oct 07, 2017 in Hipchat

Bringing Structure to your HipChat Instance

...have mention name FirstnameLastname. Fe.: @MaartenCautreels This certainly helps to know who is being mentioned in a conversation. Imagine your colleague sends the following message...

462 views 1 4
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
Atlassian Team Tour

Join us on the Team Tour

We're bringing product updates and pro tips on teamwork to ten cities around the world.

Save your spot