Webhooks: Customer Events · Innovorder API Documentation

Customer webhooks allow you to track changes to user profiles, including name changes, email updates, badge assignments, and account lifecycle (creation, updates, and deletion).

Available Events

customer.firstName.updatedTriggered when the first name is modified.
customer.lastName.updatedTriggered when the last name is modified.
customer.email.updatedTriggered when an existing email is updated.
customer.email.addedTriggered when a new email is added to a profile.
customer.account.addedTriggered when a customer account is created.
customer.account.updatedTriggered when an account changes: profile, badges, e-wallet balance, or activation status (enable/disable).
customer.account.deletedTriggered when a customer account is archived (removed from the referential).
customer.badgeNumber.updatedTriggered when the badge number (RFID/NFC) is changed.
customers.importedTriggered when a customer is imported via external tools.

Payload Examples

Badge Update

json

{
  "brandId": 10,
  "siteId": "22ED2E",
  "customerId": 8,
  "badgeNumber": "74195",
  "eventType": "customer.badgeNumber.updated"
}

Email Update

json

{
  "brandId": 10,
  "siteId": "22ED2E",
  "customerId": 8,
  "email": "john.doe@example.com",
  "eventType": "customer.email.updated"
}

Name Update

json

{
  "brandId": 10,
  "siteId": "22ED2E",
  "customerId": 8,
  "firstName": "John",
  "eventType": "customer.firstName.updated"
}

Import Event

json

{
  "brandId": 10,
  "siteId": "22ED2E",
  "customerId": 8,
  "eventType": "customers.imported"
}

Account Created / Updated

json

{
  "brandId": 10,
  "siteId": "22ED2E",
  "customerId": 8,
  "email": "john.doe@example.com",
  "balance": 675,
  "accountPaymentType": "PREPAYMENT",
  "lastSeenAt": "2026-03-25T12:32:00.000Z",
  "disabledAt": null,
  "badges": [
    { "value": "3994260718", "type": "classic", "isBlocked": false }
  ],
  "eventType": "customer.account.added"
}

Account Deleted

json

{
  "brandId": 10,
  "siteId": "22ED2E",
  "customerId": 8,
  "eventType": "customer.account.deleted"
}

Account events carry a full snapshot. Every customer.account.added and customer.account.updated delivery contains the complete account state at the time of the change (email, balance, payment type, badges, activation status), regardless of which field triggered it. A disabled account is signalled by a non-null disabledAt; a customer.account.deleted event carries only the identifiers.

Field Reference

Field	Type	Description
brandId	Integer	The unique identifier of the brand.
siteId	String	External identifier of the site (restaurant).
customerId	Integer	The unique identifier of the customer.
eventType	String	The specific event name (e.g., `customer.email.updated`).
firstName	String	Present in name update events.
lastName	String	Present in name update events.
email	String	Present in email update/add events.
badgeNumber	String	Present in badge update events.
balance	Integer	Present in `customer.account.added`/`updated` events. Current e-wallet balance, in cents.
accountPaymentType	String	Present in `customer.account.added`/`updated` events. One of `PREPAYMENT`, `POSTPAYMENT`, `CASH`, or `null`.
lastSeenAt	String	Present in `customer.account.added`/`updated` events. ISO 8601 (UTC) timestamp of the last activity, or `null`.
disabledAt	String	Present in `customer.account.added`/`updated` events. ISO 8601 (UTC) timestamp when the account was disabled, or `null` when active.
badges	Array	Present in `customer.account.added`/`updated` events. Each item is `{ value, type, isBlocked }` (`type` is `classic` or `toqla`).