PMP Events

Inbound v3 events post the per message based pricing roll out on 1st July 2025

Sent

Key Changes in Sent event V3
  • Addition of new key type inside pricing object
  • Value of pricing_model key to change from CBP to PMP
{
  "entry": [
    {
      "changes": [
        {
          "field": "messages",
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "{{APP_PHONE}}",
              "phone_number_id": "{{PHONE_ID}}"
            },
            "statuses": [
              {
                "conversation": {
                  "expiration_timestamp": "1710936120",
                  "id": "{{CONVERSATION_ID}}",
                  "origin": {
                    "type": "service"
                  }
                },
                "gs_id": "{{GS_MESSAGE_ID}}",
                "id": "{{WA_MESSAGE_ID}}",
                "pricing": {
                  "billable": true,
                  "category": "marketing",
                  "pricing_model": "PMP",
                  "type": "regular"
                },
                "recipient_id": "{{END_USER_PHONE_NUMBER}}",
                "status": "sent",
                "timestamp": "1710930461"
              }
            ]
          }
        }
      ],
      "id": "112535025189792"
    }
  ],
  "gs_app_id": "{{APP_NAME}}",
  "object": "whatsapp_business_account"
}

Payload Description

KeyDescriptionExample
objectType of object that sent the eventwhatsapp_business_account
gs_app_idGupshup application ID7bf06899-5f0f-4cca-be3b-xxxxxxxxxx
metadata.display_phone_numberDisplay phone number9******8
metadata.phone_number_idPhone number ID158072934066266
statuses[].conversation.idConversation ID0f957b88cfb1558f6199exxxxxxxx
statuses[].idWhatsApp message ID (wamid)d04cc3a7-18f0-4571-831e-xxxxxxxx
statuses[].recipient_idDestination phone number79507xxxxx
statuses[].statusMessage statussent
statuses[].timestampTimestamp (in seconds)1739354482

Delivered


Key Changes in Delivered event V3
  • Addition of new key type inside pricing object
  • Value of pricing_model key to change from CBP to PMP

{
  "entry": [
    {
      "changes": [
        {
          "field": "messages",
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "{{APP_PHONE}}",
              "phone_number_id": "{{PHONE_ID}}"
            },
            "statuses": [
              {
                "conversation": {
                  "expiration_timestamp": "1710936120",
                  "id": "{{CONVERSATION_ID}}",
                  "origin": {
                    "type": "service"
                  }
                },
                "gs_id": "{{GS_MESSAGE_ID}}",
                "id": "{{WA_MESSAGE_ID}}",
                "pricing": {
                  "billable": true,
                  "category": "marketing",
                  "pricing_model": "PMP",
                  "type": "regular"
                },
                "recipient_id": "{{END_USER_PHONE_NUMBER}}",
                "status": "sent",
                "timestamp": "1710930461"
              }
            ]
          }
        }
      ],
      "id": "112535025189792"
    }
  ],
  "gs_app_id": "{{APP_NAME}}",
  "object": "whatsapp_business_account"
}

Payload Description

KeyDescriptionExample
objectType of object that sent the eventwhatsapp_business_account
gs_app_idGupshup application ID7bf06899-5f0f-4cca-be3b-xxxxxxxxxx
metadata.display_phone_numberDisplay phone number9******8
metadata.phone_number_idPhone number ID158072934066266
statuses[].conversation.idConversation ID0f957b88cfb1558f6199exxxxxxxx
statuses[].idWhatsApp message ID (wamid)d04cc3a7-18f0-4571-831e-xxxxxxxx
statuses[].recipient_idDestination phone number79507xxxxx
statuses[].statusMessage statusdelivered
statuses[].timestampTimestamp (in seconds)1739354482

Billing

Key Changes for Billing Event V3
  • Removal of conversation_id and conversation_type key
  • Addition of new key category
  • Value of model key to change from CBP to PMP
  • typekey inside deductions object to take up new values (refer table below for supported values)
{
  "entry": [
    {
      "changes": [
        {
          "field": "billing-event",
          "value": {
            "billing": {
              "deductions": {
                "billable": true,
                "model": "PMP",
                "source": "whatsapp",
                "type": "regular",
                "category": "marketing"
              },
              "references": {
                "destination": "919163805873",
                "gs_id": "01e8e5c8-a171-457f-af7a-9723c60a95b5",
                "id": "0f19ef62-80ef-48c2-a493-9ac112478d20"
              }
            }
          }
        }
      ]
    }
  ],
  "gs_app_id": "13ecfc3d-499c-42f4-ba59-1604f8654389",
  "object": "whatsapp_business_account"
}

Payload Description

KeyDescriptionExample
objectType of object that sent the eventwhatsapp_business_account
gs_app_idGupshup application IDxxxxxxx23d31f949e98869bc9a1xxxxxx
metadata.display_phone_numberDisplay phone number79507xxxxxxxx
metadata.phone_number_idPhone number ID158072934066266
statuses[].conversation.idConversation ID3dabdf65abaf1cbbf85217d232cce91f
statuses[].idWhatsApp message ID (wamid)d04cc3a7-18f0-4571-831e-xxxxxxxx
statuses[].recipient_idDestination phone number79507xxxxxxxx