v36

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-017439390.7 KB

Create Customer

Create or update a customer profile in Gameball using a unique customerId. Serving as a consistent identity, this customerId allows you to track a customer's entire journey.

post/api/v4.0/integrations/customers

Request body

customerIdstring 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.

emailstring

Customer's email address. Required if your account uses email-based channel merging.

mobilestring

Customer's mobile number. Required if your account uses mobile-based channel merging.

deviceTokenstring

Token used to identify the device.

osTypestring

Operating system type of the device.

referrerCodestring

The referral code of an existing customer who is referring the customer being created. This is required in the create customer request to process the referral.

guestboolean

A flag indicating if the individual interacting with your system is a guest (not signed up). Set this to true for guest users; otherwise, they are treated as registered customers by default.

Response

Customer created or updated successfully

gameballIdnumber

The customer's unique ID within the Gameball system. This ID is used to store the customer in our database and is different from the customerId used in the dashboard.

All 75 operations