Sign in

Reporting webhook format

Customer.io sends events to your webhook URL in the following format. Events are generally organized by object_type—representing the message or Customer.io action (i.e. email, sms, etc)—and the specific metric pertaining to the type (i.e. sent, bounced, etc).

postWebhookreportingWebhook

Headers

x-cio-timestampinteger required

The timestamp when the request was sent.

x-cio-signaturestring required

A string combining your webhook signing key with the body of webhook request using an HMAC-SHA256 hash, used to help you securely verify requests.

Payload

OR
OR
OR
OR
OR
OR
OR

Example payload

{
  "event_id": "01E4C4CT6YDC7Y5M7FE1GWWPQJ",
  "object_type": "customer",
  "timestamp": 1613063089,
  "data": {
    "customer_id": "42",
    "email_address": "test@example.com",
    "identifiers": {
      "id": "42",
      "email": "test@example.com",
      "phone": "+15558675309",
      "cio_id": "d9c106000001"
    }
  }
}

Changes