Groups

Create a WhatsApp group seeded with members of your choice. The business number becomes the admin; members are added as part of the create call.


POST /api/v25.0/{PHONE_NUMBER_ID}/groups
Authorization: Bearer pk_live_<your-key>
Content-Type: application/json

Request body


{
  "messaging_product": "whatsapp",
  "subject":  "Diwali VIP Customers",
  "members": [
    "+919999999999",
    "+919888888888",
    "+919777777777"
  ]
}

Field	Notes
`subject`	Group display name, ≤ 100 characters
`members`	Array of E.164 phone numbers to add. Each must have an active WhatsApp account. Max 256 members per group

Response — 200


{
  "group_id":   "[email protected]",
  "invite_url": "https://chat.whatsapp.com/ABC123XYZ",
  "added_members": [
    { "input": "+919999999999", "wa_id": "919999999999" }
  ],
  "errors": [
    { "input": "+919777777777", "code": 131009, "message": "Recipient phone number does not have a WhatsApp account" }
  ]
}

group_id is opaque — store it alongside the customer’s account if you need to reference the group later (for sending messages, adding more members, etc.).

invite_url is a permanent join link until revoked from the WhatsApp client.

Send a message into a group

Use Send Messages with the group_id as to:


{
  "messaging_product": "whatsapp",
  "to":                "[email protected]",
  "type":              "text",
  "text":              { "body": "Welcome to the VIP group!" }
}

Errors

Body	When
`(#100) subject is too long`	Trim to ≤ 100 chars
`(#100) Maximum 256 members per group`	Split into multiple groups
`(#131009) Recipient phone number does not have a WhatsApp account`	Per-member error — surfaces in the `errors` array, not as a top-level failure
`(#100) Group feature not enabled for this number`	Group sends are a gated feature; contact support

cURL


curl -X POST \
  "https://api.splashifypro.com/api/v25.0/$PHONE_NUMBER_ID/groups" \
  -H "Authorization: Bearer $SPLASHIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "subject":  "Diwali VIP",
    "members": [
      "+919999999999",
      "+919888888888"
    ]
  }'

Notes

Group billing. Each outbound message into a group counts as one message per member, billed at the per-category rate.
Group sends are template-only. Free-form text into a group is only allowed within the 24-hour customer service window for at least one of the members; outside that, send a UTILITY / MARKETING template.
No leave / kick / add API today. Member management after creation happens through the WhatsApp Business app, not the API.