Registers the caller's current browser for WebForms, or refreshes its existing registration, and enforces the server's per-user browser limit (webformTokenLimit) on the server.
Request body
Optional. Send {} (or no body) for a browser with no registration yet, or { "browser_token": "..." } with the value an earlier call returned to this browser.
Behaviour
- Registrations created before the last daily reset are removed. The reset happens every day at the UTC hour set by
webformTokenExpireAt(0-23). - If
browser_tokennames one of the user's live registrations, it is refreshed and the same token is returned (200). A token that is unknown, expired or someone else's is treated as absent. - Otherwise a new random token is issued (
201), unless the user already holdswebformTokenLimitlive registrations (409).
The limit check and the insert run in one transaction that locks the user, so concurrent registrations cannot exceed the limit. A limit of -1 is unlimited (remaining and resets_at are null); a limit of 0 refuses every registration with 403.
Authorization
Standard bearer token. user_id must be the caller (self or the caller's own id). Company and server admins, and internal clients, cannot register a browser for another user.
browser_token is only ever returned to its owner, by this endpoint. Keep it in the browser and send it back on the next registration.
Responses
-
OK -
browser_tokennamed one of the user's live registrations; it was refreshed and the count is unchanged. -
Created - a new registration was added for this browser.
-
Bad Request - the body is not a JSON object, or
browser_tokenis not a string of at most 50 characters. -
Unauthorized - missing or invalid bearer token.
-
Forbidden -
user_idis not the caller (no role or client may register a browser for another user),profile_idis not the caller's own profile, or the server'swebformTokenLimitis0(no access to WebForms). -
Not Found -
user_idis not a user ofprofile_id. -
Conflict - the user already holds
webformTokenLimitlive registrations. Nothing was added; retry afterresets_at.
curl \
--request POST 'https://api.iformbuilder.com/exzact/api/v81/[servername]/profiles/self/users/self/browser_tokens' \
--header "Content-Type: application/json" \
--header "Authorization: Bearer {access_token}" \
--data '{
"browser_token": "3f1c9a7e0b5d4c2a8e6f1b3d5c7a9e0f2b4d6c8a"
}'
{
"browser_token": "3f1c9a7e0b5d4c2a8e6f1b3d5c7a9e0f2b4d6c8a"
}
{
"id": 5120,
"browser_token": "3f1c9a7e0b5d4c2a8e6f1b3d5c7a9e0f2b4d6c8a",
"browser_count": 2,
"remaining": 4,
"resets_at": "2026-11-06T00:00:00+00:00"
}
{
"id": 5121,
"browser_token": "9d2e4f6a8c0b1d3e5f7a9c1b3d5e7f9a0c2e4b6d",
"browser_count": 3,
"remaining": 3,
"resets_at": "2026-11-06T00:00:00+00:00"
}
{
"id": 5122,
"browser_token": "1a3c5e7b9d0f2a4c6e8b0d1f3a5c7e9b2d4f6a8c",
"browser_count": 1,
"remaining": null,
"resets_at": null
}
{
"error_message": "You have exceeded the number of browsers you can be logged in on. WebForms cannot be accessed on this browser until after 2026-11-06T00:00:00+00:00.",
"browser_count": 6,
"resets_at": "2026-11-06T00:00:00+00:00"
}