Campaign Events
Receive CAMPAIGN.STATUS events via webhook whenever an RCS campaign's
per-carrier launch status (AT&T, T-Mobile, Verizon, other carriers) or
verification status (AEGIS, Google) changes.
Subscribe by attaching a webhook to an RCS agent sender — CAMPAIGN.STATUS
is only supported for agent senders, not phone numbers. Attempting to attach
this event to a phone number returns 400 Bad Request.
The payload includes the agent reference, the connected campaign and
brand public ids, and the full carrierLaunches object.
Before trusting the payload, verify the PINNACLE-SIGNING-SECRET header matches the signing secret of the webhook this event was delivered to. Respond with a 200 to acknowledge receipt — any non-2xx response causes Pinnacle to retry with exponential backoff.
Header Parameters
PINNACLE-SIGNING-SECRETstringSecret for verifying the authenticity of the request. Starts with pss- and is unique for each webhook. Find it at webhooks.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Webhook body delivered to subscribers of CAMPAIGN.STATUS whenever
an RCS campaign's per-carrier launch status or verification status
(AEGIS / Google) changes. CAMPAIGN.STATUS is only supported for
RCS agent senders — the attach call rejects phone-number senders
with 400 Bad Request. Verify the PINNACLE-SIGNING-SECRET header
matches the signing secret of the webhook this event was delivered
to before trusting the payload.
type"CAMPAIGN.STATUS""CAMPAIGN.STATUS"The RCS agent the campaign-status update is for.
Reference to the connected campaign.
Reference to the brand owning the agent's connected campaign.
Resolved per-key launch status for the campaign's agent. Carrier
statuses live under carriers and verifier statuses under
verification.
updatedAtstringISO 8601 timestamp of when the change was applied.