Groups API Pricing

Updated: Sep 10, 2026

Copy for LLM

Per-message pricing on Groups API

Groups API uses Cloud API’s per-message pricing model to determine if a given message is billable. However, you are charged each time a billable message is delivered to someone in the group.

For example, if you send a (billable) marketing template message to a group with 5 WhatsApp users and it is delivered to all 5 users, you would be charged for 5 delivered messages at the going marketing message rate for each recipient’s country calling code.

If the message was delivered to only 4 of the 5 users, you would only be charged for the 4 delivered messages.

How customer service windows work with Groups API

Customer service windows work differently when using Groups API.

When any WhatsApp user in the group messages you, a customer service window is opened between you and the entire group (or is refreshed, if one already exists). Through September 30, 2026, this allows you to send utility and non-template messages for free. As of October 1, 2026, utility messages sent within an open group customer service window are charged, and non-template messages are free only while the business phone number is within its free tier. The 1,000-message free tier is shared with 1:1 service messages for the same business phone number, and each group send consumes one unit per delivered recipient.

This is different from 1:1 messaging, where when a WhatsApp user messages you, a customer service window is opened between you and that customer (or is refreshed, if one already exists).

Everything else about customer service windows remains the same.

Pricing information in message status webhook

Pricing information for messages sent using Groups API is included in messages status webhooks.

How `read` and `delivered` message status webhooks are processed

In order for a message status to be considered read, it must have been at least delivered.

In some scenarios, such as when a user is present in the chat thread when a message arrives, the message is marked delivered and read nearly simultaneously. In this and other similar scenarios, the delivered webhook is not sent back. This is because it is implied that the message was delivered since it has been read.

How pricing data is displayed in the Message Status webhook

Not all Message Status webhooks include pricing information.

With the introduction of Per-message Pricing, pricing data can be present in sent, delivered or read status webhook. If a message is charged, you can expect that at least one webhook (delivered or read) will contain the pricing information.

Sent message status webhook

// All versions

"pricing": {
  "billable": "<IS_BILLABLE>",
  "pricing_model": "<PRICING_MODEL>",  // new value, see table below
  "type": "<PRICING_TYPE>",            // new property, see table below
  "category": "<CONVERSATION_CATEGORY>"
}

Delivered / Read message status webhook

// Version 24.0 and higher

"pricing": {
  "billable": "<IS_BILLABLE?>",
  "pricing_model": "<PRICING_MODEL>",  // new value, see table below
  "type": "<PRICING_TYPE>",            // new property, see table below
  "category": "<CONVERSATION_CATEGORY>"
}
// Version 23.0 and lower
"conversation": {
  "id": "<CONVERSATION_ID>",           // new behavior, see table below
  "expiration_timestamp": "<CONVERSATION_EXPIRATION_TIMESTAMP>",
  "origin": {
    "type": "<CONVERSATION_CATEGORY>"
  }
},

"pricing": {
  "billable": "<IS_BILLABLE?>",
  "pricing_model": "PMP",              // Value is now "PMP" instead of "CBP"
  "type": "<PRICING_TYPE>",            // new property, see table below
  "category": "<PRICING_CATEGORY>"
}

Parameters

Placeholder	Description
`<CONVERSATION_ID>`	Version 24.0 and higher: The `conversation` object will be omitted entirely Version 23.0 and lower: Value will now be set to a unique ID per-message, instead of per-conversation.
`<CONVERSATION_CATEGORY>`	Not changing.
`<CONVERSATION_EXPIRATION_TIMESTAMP>`	Not changing.
`<IS_BILLABLE?>`	Not changing. However, the `billable` property will be deprecated in a future versioned release. Start using `pricing.type` and `pricing.category` together to determine if a message is billable, and if so, its billing rate.
`<PRICING_TYPE>`	New property. Values can be: `regular` — indicates the message is billable. `free_group_customer_service` — through September 30, 2026, indicates a utility template message or non-template message sent within a group customer service window. As of October 1, 2026, indicates a group service delivery within the business phone number’s free tier.
`<PRICING_CATEGORY>`	Values are not changing, but can now be interpreted as follows: `group_marketing` — indicates a marketing template message. `group_utility` — indicates a utility template message. `group_service` — indicates a non-template message.

Identifying billable messages

Billable messages have pricing.type set to regular. Through September 30, 2026, billable pricing.category values are group_marketing and group_utility. As of October 1, 2026, billable categories are:

group_marketing — marketing messages.
group_utility — utility messages, including those sent within an open group customer service window.
group_service — non-template messages delivered after the business phone number’s free tier has been used.

Identifying free messages

Free messages have pricing.type set to free_group_customer_service. The pricing.category value identifies the message category:

Through September 30, 2026, group_utility identifies a utility message sent within an open group customer service window.
Through September 30, 2026, group_service identifies a non-template message sent within an open group customer service window.
As of October 1, 2026, group_service identifies a free non-template message delivered while the business phone number is within its free tier.

Messaging analytics for Groups API

The analytics field provides the number and type of messages sent and delivered by the phone numbers associated with a specific Messaging account — for conversation metrics, see Conversation Analytics.

You can use the following endpoint to retrieve analytics for messages sent using Groups API:

/<WHATSAPP_BUSINESS_ACCOUNT_ID>?fields=analytics.<FILTER_PARAMETER>.<FILTER_PARAMETER>...

Filter parameters for messaging analytics

For a full list of messaging analytics filter parameters, view the Messaging Analytics reference.

Changes to filter parameters for Groups API

Name Description

Name	Description
`product_types` type: Array	Optional. The types of messages (notification messages and/or customer support messages) for which you want to retrieve notifications. Provide an array and include: `101` for group notification messages `102` for group customer support messages. `103` for inbound group messages If the above values are not provided, the API call will return analytics for all messages together. Inbound product type cannot be queried together with other product types, or you will see an error similar to the one below: `{ "error": { "message": "Invalid parameter", "type": "OAuthException", "code": 100, "error_subcode": 2388077, "is_transient": false, "error_user_title": "Insight Invalid Product Type Combination", "error_user_msg": "Unable to query this combination of product types. Please query individually and try again.", } }`

product_types

type: Array

Optional.

The types of messages (notification messages and/or customer support messages) for which you want to retrieve notifications.

Provide an array and include:

101 for group notification messages
102 for group customer support messages.
103 for inbound group messages

If the above values are not provided, the API call will return analytics for all messages together.

Inbound product type cannot be queried together with other product types, or you will see an error similar to the one below:

 {
 "error": {
   "message": "Invalid parameter",
   "type": "OAuthException",
   "code": 100,
   "error_subcode": 2388077,
   "is_transient": false,
   "error_user_title": "Insight Invalid Product Type Combination",
   "error_user_msg": "Unable to query this combination of product types. Please query individually and try again.",
 }
}

Response value

Successful responses to the analytics API when querying Groups API message data will return an object similar to the following:

Note: The country code filter is not supported for group sent messages.

With Country code filter
{
  "analytics": {
    "phone_numbers": [
      "16505550111",
      "16505550112",
      "16505550113"
    ],
    "country_codes": [
      "US",
      "BR"
    ],
    "granularity": "DAY",
    "data_points": [
      {
        "start": 1543543200,
        "end": 1543629600,
        "sent": 196093,
        "delivered": 179715,
        "groups_delivered": 4
      },
      {
        "start": 1543629600,
        "end": 1543716000,
        "sent": 147649,
        "delivered": 139032
      }
      # more data points
    ]
  },
  "id": "102290129340398"
}

Without Country code filter
{
  "analytics": {
    "phone_numbers": [
      "16505550111",
      "16505550112",
      "16505550113"
    ],
    "granularity": "DAY",
    "data_points": [
      {
        "start": 1543543200,
        "end": 1543629600,
        "sent": 196093,
        "delivered": 179715,
        "groups_sent": 2,
        "groups_delivered": 4
      },
      {
        "start": 1543629600,
        "end": 1543716000,
        "sent": 147649,
        "delivered": 139032
      }
      # more data points
    ]
  },
  "id": "102290129340398"
}

Pricing analytics for Groups API

The pricing_analytics field allows you to get pricing breakdowns for any messages delivered within a specified date range.

GET /<WABA_ID>
?fields=pricing_analytics
.start(<START>)
.end(<END>)
.granularity(<GRANULARITY>)
.phone_numbers(<PHONE_NUMBERS>)
.country_codes(<COUNTRY_CODES>)
.metric_types(<METRIC_TYPES>)
.pricing_types(<PRICING_TYPES>)
.pricing_categories(<PRICING_CATEGORIES>)
.dimensions(<DIMENSIONS>)

Filter parameters for pricing analytics

For a full list of messaging analytics filter parameters, view the Messaging Analytics reference.

Changes to filter parameters for Groups API

Name Description

Name	Description
`<PRICING_CATEGORIES>` Array of strings	Optional. Array of pricing categories. If you send an empty array, you receive results for all pricing categories. Values can be: `GROUP_MARKETING`: Group messages charged the marketing rate. `GROUP_SERVICE`: Through September 30, 2026, group messages that were not charged, including non-template messages and utility messages sent within a group customer service window. As of October 1, 2026, group non-template messages. `GROUP_UTILITY`: Through September 30, 2026, group messages charged the utility rate. As of October 1, 2026, group utility messages.
`<PRICING_TYPES>` Array of strings	Optional. Array of pricing types. If you send an empty array, you receive results for all pricing types. Values can be: `FREE_GROUP_CUSTOMER_SERVICE`: Through September 30, 2026, group non-template and utility messages sent within group customer service windows. As of October 1, 2026, group non-template messages delivered within the business phone number’s free tier. `REGULAR`: Billable messages. Includes all authentication and marketing template messages, and any utility template messages sent outside of a customer service window. As of October 1, 2026, this also includes group utility messages sent within a customer service window and group non-template messages delivered after the free tier has been used.

<PRICING_CATEGORIES>

Array of strings

Optional.

Array of pricing categories. If you send an empty array, you receive results for all pricing categories.

Values can be:

GROUP_MARKETING: Group messages charged the marketing rate.
GROUP_SERVICE: Through September 30, 2026, group messages that were not charged, including non-template messages and utility messages sent within a group customer service window. As of October 1, 2026, group non-template messages.
GROUP_UTILITY: Through September 30, 2026, group messages charged the utility rate. As of October 1, 2026, group utility messages.

<PRICING_TYPES>

Array of strings

Optional.

Array of pricing types. If you send an empty array, you receive results for all pricing types.

Values can be:

FREE_GROUP_CUSTOMER_SERVICE: Through September 30, 2026, group non-template and utility messages sent within group customer service windows. As of October 1, 2026, group non-template messages delivered within the business phone number’s free tier.
REGULAR: Billable messages. Includes all authentication and marketing template messages, and any utility template messages sent outside of a customer service window. As of October 1, 2026, this also includes group utility messages sent within a customer service window and group non-template messages delivered after the free tier has been used.

Rate cards

Group utility messages are not eligible for volume tiers.

Messaging rates for Groups API are the same as per-messaging pricing rates for 1 to 1 messaging.

View per-message pricing rate cards

Groups API Pricing

Per-message pricing on Groups API

How customer service windows work with Groups API

Pricing information in message status webhook

How read and delivered message status webhooks are processed

How pricing data is displayed in the Message Status webhook

Sent message status webhook

Delivered / Read message status webhook

Parameters

Identifying billable messages

Identifying free messages

Messaging analytics for Groups API

Filter parameters for messaging analytics

Changes to filter parameters for Groups API

Response value

Pricing analytics for Groups API

Filter parameters for pricing analytics

Changes to filter parameters for Groups API

Rate cards

How `read` and `delivered` message status webhooks are processed