Customer Profile Updates

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.

This webhook ensures that your systems reflect the most accurate and up-to-date customer information.

Customer Profile Webhook POST Data

{
  "event": "customer.profile.updated",
  "client_id": "2155",
  "customer_id": "webhook-test",
  "gb_customer_id": 1234,
  "created_at": "2024-11-19T17:34:42.297Z",
  "data": {
    "email": "customer@example.com",
    "mobile_number": "+XX-XXXX-XXXX",
    "tier_name": "basic",
    "tier_order": 1,
    "referral_code": "referral_123",
    "referral_link": "www.example.com",
    "activated_points": 90,
    "pending_points": 10,
    "total_points": 100
  }
}

Webhook Fields

event

string

required

This indicates that the event triggering the webhook is related to a customer profile update

client_id

string

required

The unique identifier for the client (your app) that’s receiving the webhook.

customer_id

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.

gb_customer_id

number

required

The Gameball internal identifier for the customer.

created_at

string

required

The timestamp when the webhook event was created, formatted in ISO 8601.

data

object

required

This contains the updated customer profile data.

Show Customer Profile Object

string

The customer’s email address.

mobile_number

string

The customer’s mobile number.

tier_name

string

The customer’s current loyalty tier name.

tier_order

number

The order/level of the customer’s current loyalty tier.

referral_code

string

A referral code associated with the customer.

referral_link

string

A referral link for the customer.

activated_points

number

The points the customer has currently activated and can use.

pending_points

number

Points that are pending and will be activated later.

total_points

number

The customer’s total accumulated points, including both activated and pending points.

API documentation

Webhooks

Customer Profile Updates

Customer Profile Webhook POST Data

Webhook Fields

​Customer Profile Webhook POST Data

​Webhook Fields

Customer Profile Webhook POST Data

Webhook Fields