Create a group
Create a new group. There are two modes:
1. Link to existing iMessage chat: Provide chat_guid to join an existing group chat that was created elsewhere (e.g., on the device natively). The members list records who is in the group but does NOT add them to the device chat. Multiple groups can have the same participants if they have different chat_guids.
2. Create new group: Omit chat_guid to create a new group. When you send the first message, a new iMessage chat will be created. Note: iMessage only allows one chat per unique participant set when created via API.
Authorization
BearerAuth API key authentication. Use your API key as the bearer token.
In: header
Request Body
application/json
Group name (max 255 characters)
BlueBubbles chat GUID to link this group to an existing iMessage chat. Use this to join groups created elsewhere. You can get this from the BlueBubbles API or from inbound message webhooks.
Phone numbers or emails of contacts in the group. When linking via chat_guid, this is for record-keeping only (members are not added to the device chat).
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://backend.blooio.com/v2/api/groups" \ -H "Content-Type: application/json" \ -d '{ "name": "Sales Team" }'{
"group_id": "string",
"name": "string",
"chat_guid": "string",
"member_count": 0,
"created_at": 0
}{
"error": "string",
"status": 0
}{
"error": "string",
"status": 0
}{
"error": "string",
"status": 0
}