{
"ok": true,
"profile_id": "prof_9f2c1a7e4d3b4a11"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "Too many requests"
}{
"error": "<string>",
"message": "<string>"
}Identify a viewer
Resolves or mints a viewer profile from identity signals claimed by the page: a raw or pre-hashed email or phone, your own customer ID, or a session or device ID. No token is required or checked; the endpoint is public, CORS-enabled, and rate-limited per IP instead.
Because the caller is unauthenticated, a page-claimed identity is written at the lowest rung of TrackPlay’s confidence ladder. A verified lead-form submission or a server-to-server event carrying the same email outranks it and wins on conflict.
Send a raw email together with video_code and TrackPlay also tees a lead into the workspace’s lead list for that video, in addition to writing the identity graph edge. Pre-hashed email alone does not: a hash cannot populate a human-readable lead record.
Server: https://e.trackplay.io
{
"ok": true,
"profile_id": "prof_9f2c1a7e4d3b4a11"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "Too many requests"
}{
"error": "<string>",
"message": "<string>"
}Body
At least one identity signal is required: email, email_sha256, email_md5, phone, phone_sha256, phone_md5, external_id, session_code, device_id, or device_global_id. A payload naming none of them is rejected, because it would mint an identity that nothing can ever resolve back to. Any field not listed here is rejected outright: the schema is closed.
Your workspace's public code. Required.
100The video this identity is associated with. Send it along with a raw email to also tee a lead into the workspace's lead list.
100The tracker's session ID, if you have one.
100The tracker's local device ID, if you have one.
100100A raw email address. Hashed on arrival to both SHA-256 and MD5, and never stored raw.
255A pre-hashed email, lowercase hex, if you hash client-side instead of sending it raw.
^[0-9a-f]{64}$^[0-9a-f]{32}$A raw phone number. Normalized to E.164 and hashed on arrival.
64^[0-9a-f]{64}$^[0-9a-f]{32}$Your own customer ID, if you already have one for this viewer.
1202000