Documentation

Set attributes

POST/v1/widget/attributes

Auth: Site public key (rk_pk_)

Set unverified browser-side visitor attributes.

Body parameters

NameTypeDescription
attributesrequiredobjectAttribute key-value pairs
sitePublicKeyrequiredstringrk_pk_… key
visitorFingerprintrequiredstringBrowser fingerprint

Responses

200Updated visitor
{
  "visitor": {
    "id": "770e8400-e29b-41d4-a716-446655440002",
    "externalId": "usr_123",
    "email": "ada@example.com",
    "name": "Ada Lovelace",
    "attributes": {
      "plan": "pro"
    },
    "createdAt": "2026-01-04T10:00:00Z"
  }
}