Skip to main content

Group messaging | Developer Documentation

Group messaging

Updated: Nov 14, 2025

Overview

This document provides comprehensive information on the APIs and webhooks available for sending and receiving messages within groups. It details support for various message types, including:
    Text messagesMedia messagesText-based templatesMedia-based templates

    Subscribe to groups metadata webhooks

    In order to receive webhook notifications for metadata about your groups, please subscribe to the following webhook fields:
      group_lifecycle_updategroup_participants_updategroup_settings_updategroup_status_update
      For a full reference of webhooks for the Groups API, please visit our Webhooks for Groups API reference.

      Receive group messages

      You can use the following webhooks to receive statuses on messages received in the group.
      The message object includes a group_id field to indicate this is a group message. The from field in the message object and the contact object point to the same participant who sends this message.

      Group message status webhooks

      When you send messages to a group, you will receive a webhook when the message is delivered or read.
      Instead of sending multiple webhooks for each status update, we will send an aggregated webhook.
      This means that if you send a message and are set to receive several read or delivered statuses, we will send you a single, aggregated webhook that contains multiple status objects.
      Each webhook you receive is only ever in reference to a single message sent to a single group and a single status type.