Report user activity
Report any retention-indicating activity for a user (e.g. an app open or session). Send a single object or a `batch` of up to 250.
/v1.0/user/activityAuthorization
x-api-key x-date x-signature x-api-version Your organization API key.
In: header
Request timestamp as an IMF-fixdate string (GMT, US locale) "EEE, dd MMM yyyy HH:mm:ss z", e.g. "Sun, 06 Dec 2020 12:59:11 GMT". 30-second TTL.
In: header
HMAC-SHA256(x-date, secret) as lowercase hex.
In: header
Optional for the Audience API — accepted and ignored; included for consistency with the External API (where it is required). Send 1.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
Try it
live — writes real dataKept in this tab only and signed in your browser — your secret never leaves your device.
Body (JSON)
This sends a real POST to your live organization.
Enter your key and secret to send.
curl -X POST "https://example.com/v1.0/user/activity" \ -H "Content-Type: application/json" \ -d '{ "userId": "user_123" }'{ "message": "Signature expired"}List identified users
Return the ids of users already known/identified, paginated with an opaque `next` pointer.
Set or remove user properties
Add or remove key/value attributes on a user record. Omit `value` to remove a property. Send a single object or a `batch` of up to 250. To set a **date** value, send a string in one of two formats: - Strict HTTP-date (RFC 2616 IMF-fixdate), e.g. `Mon, 14 Feb 2022 20:35:03 GMT`. - ISO 8601 date & time, e.g. `2023-05-12`, `2023-05-12T14:30:00Z`, `2023-05-12T14:30:00+05:30`, or `2023-05-12T14:30:00.123Z`.