Groupsv2

Create a group

POST/groups

Create a new group. No iMessage conversation exists yet: the first message you send to the group opens it.

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

nameRequiredstring

Group name (max 255 characters)

membersoptionalstring[]

Phone numbers or emails of contacts in the group.

Returns

group_idoptionalstring

nameoptionalstring | null

Group name. Null for unnamed groups.

chat_guidoptionalstring | null

Deprecated. An identifier for the group's iMessage conversation, kept for existing integrations. Null until the group has one. Use group_id to identify the group.

icon_urloptionalstring | null

URL of the group icon/photo

member_countoptionalinteger

message_countoptionalinteger

Total number of messages in this group

last_message_textoptionalstring | null

Text of the most recent message in the group

last_message_timeoptionalinteger | null

Timestamp of the most recent message

last_message_directionoptionalstring

Direction of the most recent message

"inbound""outbound"

created_atoptionalinteger

added_membersoptionalstring[]

List of member identifiers that were added to the group

created_contactsoptionalstring[]

List of contacts that were auto-created

Response codes

201Group created

400Invalid request parameters

401Authentication required or invalid

409Conflict. A group with the same participants already exists in another organization that shares this number.

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/v2/api/groups \

  -H "Authorization: Bearer bl_live_..." \  -H "Content-Type: application/json" \  -d '{    "name": "Sales Team",    "members": [      "+15551234567",      "+15559876543"    ]  }'

Body object

{  "name": "Sales Team",  "members": [    "+15551234567",    "+15559876543"  ]}

Response objectexample

{  "group_id": "grp_a1b2c3d4",  "name": "Jane Doe",  "chat_guid": "grp_a1b2c3d4",  "icon_url": "https://example.com",  "member_count": 3,  "message_count": 3,  "last_message_text": "string",  "last_message_time": 0,  "last_message_direction": "inbound",  "created_at": 0,  "added_members": [    "string"  ],  "created_contacts": [    "string"  ]}