Skip to main content
POST
Create a Group Chat

What this endpoint does

It starts a new iMessage group from one of your lines and sends the first message into it. In iMessage a group is created by sending its first message, so message is required. After that the group works like any other group your line is in:
Everyone must be on iMessage. Tuco checks each person before anything is sent. If anyone isn’t on iMessage, nothing is sent and you get MEMBER_NOT_IMESSAGE with their number. Groups never fall back to SMS.

Authentication

Pass your workspace API key as a Bearer token.

Request body

Example

Response

200

Daily limits

A group counts against your line’s new conversations per day limit:
  • each person this line has never messaged (1:1 or in a group) uses 1 slot
  • people the line has messaged before use none
  • the first message counts as 1 message toward the daily message limit
All slots are taken together or not at all. If the line doesn’t have room for everyone new, nothing is sent and you get LINE_NEW_CONVERSATION_LIMIT. Example, a group of you + 2 people: both never messaged → 2 slots; one messaged before → 1 slot.

Errors

Nothing is sent on any of these unless the table says otherwise.

Webhooks and CRM

  • The first message fires group.message.sent, exactly once.
  • If your workspace has a CRM connected, the message is logged on each member’s contact, and a contact is created for anyone the CRM doesn’t have. See Group chats in your CRM.

What you can’t do