Contacts

Contacts management

Create or update a contact

post

Creates or updates a contact using a client-owned identifier. The contact.id field is mandatory and represents the identifier used by the client system. Optional fields (email, phone, language, name, etc.) will update the existing contact if provided. Additional properties are treated as custom 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

Responses

200

Contact updated

application/json

201

Contact created

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/contacts/save/{populationId}

HTTPcURLJavaScriptPython

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

{
  "contact": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "email": "[e-mail]",
    "phone": "[phone]",
    "language": "he",
    "name": "Dana Cohen",
    "age": "34"
  }
}

{
  "contact": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "email": "[e-mail]",
    "phone": "text",
    "language": "text",
    "name": "text",
    "lastName": "text",
    "customFields": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    }
  }
}