Groupsv4

Create a group

POST/groups

Creates a group chat on a group-capable channel (blooio/whatsapp) with one or more members.

Headers

AuthorizationRequiredstring

Your API key, sent as a bearer token: Authorization: Bearer <api_key>. Editing this stays in sync with the API key box on the right.

Bearer

Body parameters

JSON

channel_idRequiredstring

Must be a group-capable channel (blooio/whatsapp).

membersRequiredstring | object[]

Member phone numbers (E.164) or emails, each given as a string or an object { "identifier": "..." }.

Array of string | object

string

object

identifierRequiredstring

nameoptionalstring

Returns

dataoptionalGroup

idoptionalstring

Group id (grp_...).

channel_idoptionalstring

channel_typeoptionalstring

"blooio""twilio""whatsapp""whatsapp_business""rcs_business""amb"

nameoptionalstring | null

icon_urloptionalstring | null

chat_idoptionalstring | null

chat_linkedoptionalboolean

Whether the group is linked to a device chat.

created_atoptionalinteger

membersoptionalGroupMember[]

Array of GroupMember

identity_idoptionalstring

contact_idoptionalstring | null

roleoptionalstring

channel_typeoptionalstring

"blooio""twilio""whatsapp""whatsapp_business""rcs_business""amb"

identifieroptionalstring

Response codes

201Created group

400The request was malformed — check the path, query parameters, and body.

401Your API key is missing or invalid. Pass it as a bearer token.

422Validation failed — one or more fields in the request are invalid or missing.

Sends a live request with your values and shows the real response below. Your key is stored only in this browser.

Request

curl -X POST https://api.blooio.com/v4/groups \  -H "Authorization: Bearer bl_live_..." \  -H "Content-Type: application/json" \  -d '{    "channel_id": "ch_a1b2c3d4",    "members": [      "string"    ],    "name": "Jane Doe"  }'

Body object

{  "channel_id": "ch_a1b2c3d4",  "members": [    "string"  ],  "name": "Jane Doe"}

Response objectexample

{  "data": {    "id": "grp_a1b2c3d4",    "channel_id": "ch_a1b2c3d4",    "channel_type": "blooio",    "name": "Jane Doe",    "icon_url": "https://example.com",    "chat_id": "chat_a1b2c3d4",    "chat_linked": false,    "created_at": 0,    "members": [      {        "identity_id": "idn_a1b2c3d4",        "contact_id": "ct_a1b2c3d4",        "role": "string",        "channel_type": "blooio",        "identifier": "+15551234567"      }    ]  }}