HipChat API v2 - Send a message to a room using cURL

hipchat-v2.sh

#!/bin/bash

# Set the ROOM_ID & AUTH_TOKEN variables below.
# Further instructions at https://www.hipchat.com/docs/apiv2/auth

ROOM_ID=XXX
AUTH_TOKEN=XXX
MESSAGE="Hello world!"

curl -H "Content-Type: application/json" \
     -X POST \
     -d "{\"color\": \"purple\", \"message_format\": \"text\", \"message\": \"$MESSAGE\" }" \
     https://api.hipchat.com/v2/room/$ROOM_ID/notification?auth_token=$AUTH_TOKEN

I had to change notification for message to make it work!

@juanmaflyer, thanks for the comment, I updated the gist!

Thanks so much for this!

If you want to send the token in the Auth header instead, you can do this:

curl -H "Content-type: application/json" \
-H "Authorization: Bearer $AUTH_TOKEN" \
-X POST \
-d "{\"color\": \"purple\", \"message_format\": \"text\", \"message\": \"$MESSAGE\"}" \
https://api.hipchat.com/v2/room/$ROOM_ID/notification

Has anyone gotten this to work using a group notification token?

It does not work for me. It throws

{
  "error": {
    "code": 401,
    "message": "Authenticated requests only. See https://www.hipchat.com/docs/apiv2/auth for more information.",
    "type": "Unauthorized"
  }
}

It worked for me with personal auth token. Otherwise I was getting

{
  "error": {
    "code": 401,
    "message": "Invalid OAuth session",
    "type": "Unauthorized"
  }
}

any idea how to get it to work with a room notification token?

If you generate a token for a specific room, this script works.

https://your-company.hipchat.com/rooms/tokens/XXXX

It's quite weird that it doesn't work with an admin token, isn't it?

This works for me..:

ROOM_ID=yourroomname
OWNER_ID=XXXYYYX
AUTH_TOKEN=XXXYYYXXX
MESSAGE="Hello world!"

curl --header "content-type: application/json" --header "Authorization: Bearer $AUTH_TOKEN" -X POST \
  -d "{\"name\":\"dev\",\"privacy\":\"private\",\"is_archived\":false,\"is_guest_accessible\":false,\"topic\":\"cURL\",\"message\":\"Message sent to HipChat from cURL\",\"color\":\"green\",\"owner\":{\"id\":$OWNER_ID}}" https://api.hipchat.com/v2/room/$ROOM_ID/notification

Also can't get Auth Token i keep getting the 401 code.

Anybody know how to get this token back correctly?

edit: @bvulaj was right. you can just generate a token by trying to go to:

https://your-company.hipchat.com/rooms/tokens/XXXX

cheers!

Would I be able to alert a hipchat room via analytics unique visitor?

Thanks for posting this - it's a useful example

Thank you for sharing but i can't not follow your scripted.

Any luck sending attachments with curl?

Thanks a lot, works fine

Had to generate a token for that specific room, then it worked for me. 👍

Thanks for posting this.

Works great using a room api ID. If the room name has an embedded "/" in it, it doesn't seem to work even if I URL encode the room name.

I use the v1 api - https://gist.github.com/rquadling/29d37938b1001345c643eb9832bfda7f

What would be the syntax to send it to a single user: @username or @ALL in a room? Or is that not possible?