Hipchat service management


Please refer to Use the Hipchat integration instead.

Creation of new service integrations has been deprecated in favor of Bitbucket Cloud's webhooks, Connect integration framework, and email notifications.

With this service, you can integrate Bitbucket Cloud with Hipchat with a repository.  The service connects a single Hipchat room to one or more Bitbucket repositories. Once installed, the service sends a notification to the room each time a commit is made to the repository.  You'd need to do this for each repository; you cannot configure it for multiple repositories.

As an alternative to using this service, you can use the Hipchat Bitbucket Connector add-on.  The add-on results in the same behavior as the service.  See Use the Hipchat integration in this documentation.

If you are having trouble with the service, see Troubleshoot Bitbucket Cloud services.  

Setting Up the service

  1. Login to your Bitbucket Cloud account as a user with administrative rights to the repo(s) you would like to link.
  2. Go to the repository's homepage.
  3. Click the  settings icon in the upper right of the page.
    The system displays the repository settings. 
  4. Select Services from the lefthand sidebar.
  5. Select Hipchat from the services dropdown list.
  6. Click Add service.
  7. A new section appears for the Hipchat service. Enter the following information:

    API URL Enter http://api.hipchat.com/v1/rooms/message or similar. 
    Room ID Enter a Hipchat room ID. See How to find a Hipchat room ID below.
    Token Enter a Hipchat API Token. See How to create a Hipchat API token below. Hipchat recommends you use a notification token but you can use an admin token also.
  8. Click Save settings.

Testing your service

If you have CuRL installed, you can test the token by filling in the fields with your values:  

curl -v -X POST "https://api.hipchat.com/v1/rooms/message?format=json&auth_token=YOURTOKEN" -d "room_id=ROOM_ID&from=NAME&message=STRING"


  How to create a Hipchat API token

  1. Log into Hipchat using an account with Group admin rights.
  2. Select the  Group admin from the application menu.
  3. Choose the API tab.
  4. Set the token Type to Notification.
    Use notification tokens for integrating Hipchat with other services. 
  5. Press Create.

  How to find a Hipchat room ID

  1. Log into Hipchat.
  2. Select the My account from the application menu.
  3. Choose the Rooms tab.
  4. Select the room you want.
  5. Look for the API ID field in the room information.
Last modified on Sep 13, 2017

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.