Skip to main content
Common Use Cases:
  • Sync Customer Points and VIP Tier: Keep your CRM system up-to-date with the latest customer points and VIP tier information.
  • Track Profile Changes: Automatically update other systems or services when customer profile details change.
  • Track Program Membership: Know when a customer is excluded from or included back into your loyalty program, or deleted.
  • Track Referrals: See who referred a customer and how many customers they have referred.
This webhook ensures that your systems reflect the most accurate and up-to-date customer information.

Customer Profile Webhook POST Data

Webhook Fields

string
required
This indicates that the event triggering the webhook is related to a customer profile update
string
required
The unique identifier for the client (your app) that’s receiving the webhook.
string
required
Unique identifier for the customer that you can reference across the customer’s whole lifetime. Could be a database ID, random string, email, or anything that uniquely identifies the customer.
number
required
The Gameball internal identifier for the customer.
string
required
The timestamp when the webhook event was created, formatted in ISO 8601.
object
required
This contains the updated customer profile data.

Customer Deletion

When a customer is deleted, one final webhook is sent for that customer with is_deleted set to true. The other fields carry the customer’s last known values. No further webhooks are sent for that customer.

Notes

  • Referral counts update on the referrer’s next webhook. When a referred customer signs up or their referral is activated, the referrer’s counts change, but that alone does not trigger a webhook for the referrer. The new counts appear the next time the referrer’s profile is updated.
  • Referral counts can be null. In rare cases total_referrals, active_referrals, and pending_referrals are null when they could not be loaded for that webhook. Treat null as unknown, not as zero.
The fields status, is_deleted, referred_by_customer_id, is_referral_activated, total_referrals, active_referrals, and pending_referrals are only available on V4 webhooks. Webhooks on earlier versions keep their existing payload and do not receive a webhook when a customer is deleted.