Skip to main content
All CollectionsTelnyx SMS Guide
Group Messaging - Bulk Sending MMS
Group Messaging - Bulk Sending MMS

Learn how to utilize Telnyx's API v2 to bulk send MMS to up to 8 recipients.

Bryan McHugh avatar
Written by Bryan McHugh
Updated over a week ago

Group messaging with the Telnyx API v2

Group Messaging is a new feature designed specifically for businesses across +1 numbers within US / CAN that are seeking a streamlined, efficient and secure two-way conversations. Group Messaging builds upon the MMS (Multimedia Messaging Service) protocol in order to facilitate multi-party conversations.

Please find our developer documentation below, which can help you with your setup:

Sending a group message with Telnyx

Here is an example curl request to send a group MMS message:

curl -i -X POST \ \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"from": "+13125790427",
"to": ["+18655551234", "+13125551234"],
"text": "Greetings from Telnyx!",
"media_urls": [""]

Behavior of group messaging webhooks / detail records

  • You should receive an individual webhook status update for each recipient following the v2 schema.

  • Inbound and outbound delivery webhooks will show all participants of the group message.

  • Handset delivery status is not available for Non-Telnyx recipients within in a conversation. Therefore their status will be marked as unknown .

  • We cut individual message detail records per recipient in a group message via our portal / reporting API's.

  • An additional attribute called group_message_id is returned to allow users to correlate each individual record to the overarching group message conversation. This is returned via API response, webhooks and is also available via detailed records.

Group messaging limitations

  • Group Messaging takes place over the MMS protocol and supports a maximum of 8 recipients in a conversation.

  • Limitations of the MMS protocol apply to group messaging, more details on this can be found here:

  • This feature is only available via our v2 API. Please ensure you have a v2 webhook version selected on your messaging profile to ensure you receive inbound messages.

  • Group messaging is charged per recipient. Standard MMS rates and corresponding carrier passthrough fees apply here.

  • Only US / CAN destinations are currently supported.

Did this answer your question?