Events

Events ingestion endpoints

Register an event

post

https://api.pristo.example.comhttps://sandbox-api.pristo.example.com

/v1/populations/{populationId}/events

Sends an event to Pristo. Request must include at least one identifier: pristoContactId OR clientContactId OR phone OR email. If a contact cannot be resolved, server may return CONTACT_NOT_FOUND. Dynamic fields are key/value string pairs (0-255 chars).

Authorizations

ApiKeyAuth

X-API-KeystringRequired

API key provided by Pristo (send as header X-API-Key).

Path parameters

populationIdstring · min: 1 · max: 100Required

Population identifier (tenant segmentation / audience container).

Example: pop_123

Body

application/json

The contact object should include at least one identifier: pristoContactId OR clientContactId OR phone OR email.

eventTypeIdstringRequired

Event type identifier (client-defined or Pristo-defined)

Example: evt_purchase

occurredAtstring · date-timeOptional

ISO 8601 date-time, e.g. 2026-02-04T13:25:00Z

Responses

201

Event stored (synchronous processing)

application/json

202

Event accepted (asynchronous processing)

application/json

400

Validation error (missing identifiers, unknown dynamic field, etc.)

application/json

401

Missing or invalid API key

application/json

404

Contact not found

application/json

429

Too many requests

application/json

500

Unexpected error

application/json

post

/v1/populations/{populationId}/events

HTTPcURLJavaScriptPython

POST /v1/populations/{populationId}/events HTTP/1.1
Host: api.pristo.example.com
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 166

{
  "contact": {
    "clientContactId": "CRM-889900"
  },
  "eventTypeId": "evt_purchase",
  "occurredAt": "2026-02-04T13:25:00Z",
  "dynamicFields": {
    "orderId": "A-100200",
    "amount": "199.90"
  }
}

{
  "eventId": "e_01HZAA1BB2CC3DD4EE5FF6",
  "status": "ACCEPTED",
  "receivedAt": "2026-02-04T14:03:01.526Z"
}