Send Events

Record customer actions with metadata to power rewards and engagement.

POST /api/v4.0/integrations/events

Send Events

cURL

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"
    }
  }
}
'

200

{
  "success": true,
  "message": "Events processed"
}

Send events to capture customer actions. Each event has a name (for example, place_order) and optional metadata.

Security: Requires apikey header.

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

Show child attributes

events. {key} · object

Response

200 - application/json

Events accepted

success · boolean

message · string