Mint Web Tracking Identity

POST

api

web-tracking-identities

curl --request POST \
  --url https://api.sequenzy.com/api/v1/web-tracking-identities \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "publicKey": "<string>",
  "keyId": "<string>",
  "email": "<string>",
  "ttlHours": 123
}
'

import requests

url = "https://api.sequenzy.com/api/v1/web-tracking-identities"

payload = {
    "publicKey": "<string>",
    "keyId": "<string>",
    "email": "<string>",
    "ttlHours": 123
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({publicKey: '<string>', keyId: '<string>', email: '<string>', ttlHours: 123})
};

fetch('https://api.sequenzy.com/api/v1/web-tracking-identities', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/web-tracking-identities",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'publicKey' => '<string>',
    'keyId' => '<string>',
    'email' => '<string>',
    'ttlHours' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/web-tracking-identities"

	payload := strings.NewReader("{\n  \"publicKey\": \"<string>\",\n  \"keyId\": \"<string>\",\n  \"email\": \"<string>\",\n  \"ttlHours\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.sequenzy.com/api/v1/web-tracking-identities")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"publicKey\": \"<string>\",\n  \"keyId\": \"<string>\",\n  \"email\": \"<string>\",\n  \"ttlHours\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/web-tracking-identities")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"publicKey\": \"<string>\",\n  \"keyId\": \"<string>\",\n  \"email\": \"<string>\",\n  \"ttlHours\": 123\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "keyId": "wtk_abc123",
  "publicKey": "seq_pk_your_key",
  "email": "buyer@example.com",
  "subscriberId": "sub_abc123",
  "identityToken": "seq_wid_...",
  "expiresAt": "2026-08-18T12:00:00.000Z"
}

{
  "error": "Provide keyId or publicKey"
}

{
  "error": "This email cannot be added as a contact, so an identity cannot be minted for it"
}

{
  "error": "Active web tracking key not found"
}

Call this endpoint from your authenticated backend after you know the current user’s email. It returns a short-lived token bound to the workspace, web tracking key, normalized email, and expiry. Never call this endpoint from browser code or expose the secret API key used to authorize it. A publishable tracking key alone may append anonymous activity, but cannot attach events to a subscriber or trigger automation. If the email is not yet a contact in your workspace, minting creates one so the identified events have somewhere to land - otherwise they would be accepted and then silently dropped. The contact is created active with no list memberships and without triggering any automations; enroll it through your usual flows when you want more than event attribution. If the email cannot be added as a contact (for example a suppressed or undeliverable address), the request fails with a 400 and no token is minted. Requires commerce:write, automations:trigger, and subscribers:write (minting can create the contact).

Request

Identify the key by either keyId or publicKey. The publishable key is the value in your snippet and in the dashboard, so it is usually the one your backend already has.

string

Publishable key value (seq_pk_...) of an active web tracking key. Provide this or keyId.

string

Internal ID of an active web tracking key. Provide this or publicKey.

string

required

Email of the user authenticated by your backend. It is normalized to lowercase.

number

Token lifetime from 1 minute through 30 days. Defaults to 24 hours. Mint a fresh token when the user signs in or reaches checkout; request a longer lifetime only when re-minting is genuinely impossible.

curl -X POST "https://api.sequenzy.com/api/v1/web-tracking-identities" \
  -H "Authorization: Bearer YOUR_SECRET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "publicKey": "seq_pk_your_key",
    "email": "buyer@example.com"
  }'

Pass the returned token to the browser and identify the same email:

sequenzy.identify("buyer@example.com", response.identityToken);

Response

{
  "success": true,
  "keyId": "wtk_abc123",
  "publicKey": "seq_pk_your_key",
  "email": "buyer@example.com",
  "subscriberId": "sub_abc123",
  "identityToken": "seq_wid_...",
  "expiresAt": "2026-08-18T12:00:00.000Z"
}

{
  "error": "Provide keyId or publicKey"
}

{
  "error": "This email cannot be added as a contact, so an identity cannot be minted for it"
}

{
  "error": "Active web tracking key not found"
}

Mint Web Tracking Identity

curl --request POST \
  --url https://api.sequenzy.com/api/v1/web-tracking-identities \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "publicKey": "<string>",
  "keyId": "<string>",
  "email": "<string>",
  "ttlHours": 123
}
'

import requests

url = "https://api.sequenzy.com/api/v1/web-tracking-identities"

payload = {
    "publicKey": "<string>",
    "keyId": "<string>",
    "email": "<string>",
    "ttlHours": 123
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({publicKey: '<string>', keyId: '<string>', email: '<string>', ttlHours: 123})
};

fetch('https://api.sequenzy.com/api/v1/web-tracking-identities', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/web-tracking-identities",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'publicKey' => '<string>',
    'keyId' => '<string>',
    'email' => '<string>',
    'ttlHours' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/web-tracking-identities"

	payload := strings.NewReader("{\n  \"publicKey\": \"<string>\",\n  \"keyId\": \"<string>\",\n  \"email\": \"<string>\",\n  \"ttlHours\": 123\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.sequenzy.com/api/v1/web-tracking-identities")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"publicKey\": \"<string>\",\n  \"keyId\": \"<string>\",\n  \"email\": \"<string>\",\n  \"ttlHours\": 123\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/web-tracking-identities")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"publicKey\": \"<string>\",\n  \"keyId\": \"<string>\",\n  \"email\": \"<string>\",\n  \"ttlHours\": 123\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "keyId": "wtk_abc123",
  "publicKey": "seq_pk_your_key",
  "email": "buyer@example.com",
  "subscriberId": "sub_abc123",
  "identityToken": "seq_wid_...",
  "expiresAt": "2026-08-18T12:00:00.000Z"
}

{
  "error": "Provide keyId or publicKey"
}

{
  "error": "This email cannot be added as a contact, so an identity cannot be minted for it"
}

{
  "error": "Active web tracking key not found"
}

​Request

​Response

Request

Response