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!

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

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

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

Thanks so much for this!

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

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?

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 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?

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

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?

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

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!

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?

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

Thanks for posting this - it's a useful example

Thanks for posting this - it's a useful example

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

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

Any luck sending attachments with curl?

Any luck sending attachments with curl?

Thanks a lot, works fine

Thanks a lot, works fine

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

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.

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

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?

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