Skip to main content
POST
/
api
/
v4.0
/
integrations
/
batch
/
customers
cURL
curl --request POST \
  --url https://api.gameball.co/api/v4.0/integrations/batch/customers \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --data '
{
  "body": [
    {
      "customerId": "<string>",
      "email": "<string>",
      "mobile": "<string>",
      "deviceToken": "<string>",
      "osType": "<string>",
      "customerAttributes": {
        "displayName": "<string>",
        "firstName": "<string>",
        "lastName": "<string>",
        "email": "<string>",
        "gender": "<string>",
        "mobile": "<string>",
        "dateOfBirth": "<string>",
        "joinDate": "<string>",
        "country": "<string>",
        "city": "<string>",
        "zip": "<string>",
        "preferredLanguage": "<string>",
        "source": "<string>",
        "utms": "<array>",
        "devices": "<array>",
        "paymentMethods": "<array>",
        "totalSpent": 123,
        "lastOrderDate": "<string>",
        "totalOrders": 123,
        "avgOrderAmount": 123,
        "channel": "mobile",
        "custom": {}
      },
      "referrerCode": "<string>",
      "guest": true
    }
  ]
}
'
{
  "jobId": 123
}

​
Create Customers Batch Job

The Batch Customer API allows clients to create or update multiple customer profiles in a single API call. This is useful for bulk user imports, mass profile updates, and large-scale customer data synchronization while reducing network overhead and improving efficiency.
Security: Requires apiKey and secretKey headers.

Authorizations

​
apikey
string
header
required

Body

application/json
​
body
object[]

Response

200 - application/json

Batch customer data processing initiated successfully

​
jobId
number

The assigned job ID, which is later used for status verification and response retrieval.