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

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.

Show Customer Profile Object

string

The customer’s email address.

string

The customer’s mobile number.

string

The customer’s current loyalty tier name.

number

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

string

A referral code associated with the customer.

string

A referral link for the customer.

number

The points the customer has currently activated and can use.

number

Points that are pending and will be activated later.

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