Web Tracking Keys

Mint a web tracking identity token

Changed on

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

  • Base URL
    https://api.sequenzy.com/api/v1
  • URL
    https://api.sequenzy.com/api/v1/web-tracking-identities
  • Auth
    HTTP bearer

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

Changes

  • db3873ca3d4dRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • ba3a29c6eb33Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status