Events

Events ingestion

Send an event

post

Sends an event associated with a contact. The request must include contact.id, which is the client-owned contact identifier. Optional contact fields may be provided to enrich or update the contact data. The event requires a type and may optionally include occurredAt. Additional properties at the root level are treated as event dynamic fields.

Authorizations

ApiKeyAuth

X-API-KeystringRequired

API key (UUID)

Path parameters

populationIdstring · uuidRequired

Population identifier (UUID)

Header parameters

X-Request-Idstring · uuidOptional

Optional request correlation ID

Body

application/json

typestringRequired

Event type identifier

occurredAtstring · date-timeOptional

Other propertiesstring · max: 255Optional

Responses

201

Event stored

application/json

400

Validation error

application/json

401

Invalid or missing API key

application/json

429

Too many requests

application/json

500

Internal server error

application/json

post

/v1/sendEvent/{populationId}

HTTPcURLJavaScriptPython

POST /v1/sendEvent/{populationId} HTTP/1.1
Host: api.pristo.io
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 220

{
  "contact": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "email": "[email protected]",
    "phone": "0545898777",
    "language": "en"
  },
  "type": "purchase_completed",
  "occurredAt": "2026-02-04T13:25:00Z",
  "channel": "website",
  "amount": "135"
}

{
  "eventId": "123e4567-e89b-12d3-a456-426614174000",
  "receivedAt": "2026-02-12T22:44:24.154Z"
}