Customer Events
Afriex delivers real-time notifications to your configured webhook URL whenever a customer is created, updated, or deleted.
The payload structure is identical across all events. Only the event field changes.
Security: Every request includes an x-webhook-signature header and an x-afriex-business-id header carrying your business id. You must verify this signature using Afriex’s public key before processing. The key is an elliptic-curve (secp384r1 / P-384) key, not RSA. The signature is ECDSA with SHA-256, DER-encoded and then base64-encoded, computed over the exact raw request body, so verify it before parsing or re-serialising the JSON. See the Webhooks Overview & Security section for verification instructions.
Event Types
CUSTOMER.CREATED- A new customer has been createdCUSTOMER.UPDATED- Customer information has been updatedCUSTOMER.DELETED- A customer has been deleted
Sample Payloads
Customer Created
{
"id": "319331fa-1b25-57fe-be13-602e9f440181",
"event": "CUSTOMER.CREATED",
"createdAt": "2026-02-10T10:11:12.415Z",
"data": {
"name": "John Doe",
"email": "johndoe@gmail.com",
"phone": "+2348012345678",
"customerId": "698b0440cba7ec3daee9163d",
"countryCode": "NG",
"meta": {
"source": "whatsapp"
},
"createdAt": "2026-02-10T10:11:12.415Z",
"updatedAt": "2026-02-10T10:11:12.415Z"
}
}
Customer Updated
{
"id": "009f1583-98b8-5c58-b0f4-8d369173107d",
"event": "CUSTOMER.UPDATED",
"createdAt": "2026-02-11T15:30:45.123Z",
"data": {
"name": "John Smith",
"email": "johnsmith@gmail.com",
"phone": "+2348012345678",
"customerId": "698b0440cba7ec3daee9163d",
"countryCode": "NG",
"meta": {
"source": "whatsapp",
"verified": true
},
"createdAt": "2026-02-10T10:11:12.415Z",
"updatedAt": "2026-02-11T15:30:45.123Z"
}
}
Customer Deleted
{
"id": "ee13de17-9341-5940-af5c-1dfd1af576d4",
"event": "CUSTOMER.DELETED",
"createdAt": "2026-02-11T15:30:45.123Z",
"data": {
"name": "John Smith",
"email": "johnsmith@gmail.com",
"phone": "+2348012345678",
"customerId": "698b0440cba7ec3daee9163d",
"countryCode": "NG",
"meta": {
"source": "whatsapp",
"verified": true
},
"createdAt": "2026-02-10T10:11:12.415Z",
"updatedAt": "2026-02-11T15:30:45.123Z"
}
}
CUSTOMER.DELETED gives you the customer’s last known state. There is no slimmed-down delete payload and no deletedAt field.Body
Unique ID of this event. Every delivery attempt of the same event carries the same id, so use it to ignore a delivery you have already processed.
"8f14e45f-ceea-4e7a-9f1d-6b1c2a3d4e5f"
Identifies which customer event occurred
CUSTOMER.CREATED, CUSTOMER.UPDATED, CUSTOMER.DELETED "CUSTOMER.UPDATED"
When Afriex created the event. Retries keep this value, and the signature covers it, so you can reject a delivery that is older than you expect.
"2026-04-24T09:13:33.883Z"
The customer data relevant to this event
Show child attributes
Show child attributes
Response
Acknowledge receipt. Return any 2xx status code quickly. Response body is ignored.