Skip to main content
POST
/
api
/
v4.0
/
integrations
/
events
Send Events
curl --request POST \
  --url https://api.gameball.co/api/v4.0/integrations/events \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --data '
{
  "customerId": "1848877205",
  "events": {
    "write_review": {
      "product_id": "1653503260",
      "review": "5 Stars Product"
    }
  }
}
'
{
  "success": true,
  "message": "Events processed"
}
Send events to capture customer actions. Each event has a name (for example, place_order) and optional metadata.
Security: Provide apikey header.
Automatic Customer Creation: If the customer specified by customerId doesn’t exist in Gameball, a new customer profile will be automatically created when using this API. You don’t need to create the customer separately before sending events.

Authorizations

​
apikey
string
header
required

Body

application/json

Event payload containing the customerId and one or more events with metadata.

​
customerId
string
required

Unique identifier for the customer

​
events
object
required

A mapping of event names to metadata objects

Response

200 - application/json

Events accepted

​
success
boolean
​
message
string