Create or update profiles (sync) | Documentation

curl -L \
  -X POST \
  -H 'Content-Type: application/json' \
  'https://experience.ninetailed.co/v2/organizations/{organizationId}/environments/{environmentSlug}/events' \
  -d '{"events":[{"channel":"web","context":{"library":{"name":"Ninetailed Analytics SDK","version":"1.0.0"},"locale":"en-US","page":{"path":"/","query":{},"referrer":"","search":"","url":"https://example.com/"}},"messageId":"58f358f2-a858-11ed-afa1-0242ac120002","anonymousId":"18635fe9cc665fd113547e897c13862b","timestamp":"2022-01-01T00:00:00.000Z","type":"page","properties":{"title":"Sample Page","url":"https://example.com/","path":"/","hash":"","search":"","width":1419,"height":1226,"query":{},"referrer":""}},{"channel":"web","context":{"library":{"name":"Ninetailed Analytics SDK","version":"1.0.0"},"locale":"en-US","page":{"path":"/","query":{},"referrer":"","search":"","url":"https://example.com/"}},"messageId":"68a459e3-b959-22fe-bfb2-1353bd230003","anonymousId":"18635fe9cc665fd113547e897c13862b","userId":"user1","traits":{},"timestamp":"2022-01-01T00:00:01.000Z","type":"identify"}]}'

{
  "data": {
    "profiles": [
      {
        "id": "18635fe9cc665fd113547e897c13862b",
        "stableId": "18635fe9cc665fd113547e897c13862b",
        "random": 0.73,
        "audiences": [],
        "traits": {},
        "location": {},
        "session": {}
      }
    ]
  },
  "error": null,
  "message": "ok"
}

Upserts up to 200 profiles from a batch of events (max 50 identify events, 50 unique profiles); returns profiles only — no experiences or changes. Intended for server-side use and does not resolve location or IP address.

Path parameters

environmentSlugstringRequiredDefaults to main

The slug of the environment of the profile to retrieve

organizationIdstringRequired

The ID of the organization of the profile to retrieve

Query parameters

localestringOptionalDefaults to en

An ISO 639-1 language code used for experience evaluation.

Request

This endpoint expects an object.

Response

Successful response

Errors

400

Bad Request Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error