latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-18269154992.5 KB

8fbabe82a04d

Web Tracking Keys

Mint a web tracking identity token

Mints a short-lived HMAC proof bound to one active web tracking key, workspace, and normalized email. Identify the key by keyId or by its publishable publicKey value. If the email is not yet a contact, one is created (active, no lists, no automations triggered) so identified events are attributed instead of being silently dropped. Call this only from an authenticated backend; never expose the secret API key in browser code. Identified browser events without this proof are rejected before queueing. Requires commerce:write, automations:trigger, and subscribers:write (minting can create the contact).

post/web-tracking-identities

Request body

keyIdstring

Internal web tracking key ID. Provide this or publicKey.

publicKeystring

Publishable key value (seq_pk_...). Provide this or keyId.

emailstring email required
ttlHoursnumber

Response

Identity proof minted

successboolean
keyIdstring
publicKeystring
emailstring email
subscriberIdstring

Contact the minted identity resolves to; created on first mint for a new email.

identityTokenstring
expiresAtstring date-time