Register a WebForms Browser

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://apidocs.zerionsoftware.com/doc/iformbuilder-v80/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
{
  "iFormBuilder V80 MCP server": {
    "url": "https://apidocs.zerionsoftware.com/doc/iformbuilder-v80/mcp"
  }
}

Close
POST /profiles/{profile_id}/users/{user_id}/browser_tokens

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

  1. Registrations created before the last daily reset are removed. The reset happens every day at the UTC hour set by webformTokenExpireAt (0-23).
  2. If browser_token names 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.
  3. Otherwise a new random token is issued (201), unless the user already holds webformTokenLimit live 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.

Headers

  • Authorization string

    e.g. Bearer {access_token}

Path parameters

  • profile_id string Required

    id of the profile

  • user_id string Required

    id of the user; must be the caller

application/json

Body

  • browser_token string

    the token an earlier registration returned to this browser

    Maximum length is 50.

Responses

  • 200 application/json

    OK - browser_token named one of the user's live registrations; it was refreshed and the count is unchanged.

    Hide response attributes Show response attributes object
    • id integer Required

      the registration id, for DELETE .../browser_tokens/{browser_token_id}

    • browser_token string Required

      this browser's token; send it back on the next registration

    • browser_count integer Required

      the user's live registrations, this one included

    • remaining integer | null Required

      registrations left before the limit; null when the limit is -1 (unlimited)

    • resets_at string | null Required

      the next daily reset (UTC), when registrations from before it stop counting; null when the limit is -1

  • 201 application/json

    Created - a new registration was added for this browser.

    Hide response attributes Show response attributes object
    • id integer Required

      the registration id, for DELETE .../browser_tokens/{browser_token_id}

    • browser_token string Required

      this browser's token; send it back on the next registration

    • browser_count integer Required

      the user's live registrations, this one included

    • remaining integer | null Required

      registrations left before the limit; null when the limit is -1 (unlimited)

    • resets_at string | null Required

      the next daily reset (UTC), when registrations from before it stop counting; null when the limit is -1

  • 400

    Bad Request - the body is not a JSON object, or browser_token is not a string of at most 50 characters.

  • 401

    Unauthorized - missing or invalid bearer token.

  • 403

    Forbidden - user_id is not the caller (no role or client may register a browser for another user), profile_id is not the caller's own profile, or the server's webformTokenLimit is 0 (no access to WebForms).

  • 404

    Not Found - user_id is not a user of profile_id.

  • 409 application/json

    Conflict - the user already holds webformTokenLimit live registrations. Nothing was added; retry after resets_at.

    Hide response attributes Show response attributes object
    • error_message string Required
    • browser_count integer Required

      the user's live registrations

    • resets_at string Required

      the next daily reset (UTC), after which registration can succeed

POST /profiles/{profile_id}/users/{user_id}/browser_tokens
curl \
 --request POST 'https://api.iformbuilder.com/exzact/api/v80/[servername]/profiles/self/users/self/browser_tokens' \
 --header "Content-Type: application/json" \
 --header "Authorization: Bearer {access_token}" \
 --data '{
  "browser_token": "3f1c9a7e0b5d4c2a8e6f1b3d5c7a9e0f2b4d6c8a"
}'
Request example
{
  "browser_token": "3f1c9a7e0b5d4c2a8e6f1b3d5c7a9e0f2b4d6c8a"
}
Response examples (200)
{
  "id": 5120,
  "browser_token": "3f1c9a7e0b5d4c2a8e6f1b3d5c7a9e0f2b4d6c8a",
  "browser_count": 2,
  "remaining": 4,
  "resets_at": "2026-11-06T00:00:00+00:00"
}
Response examples (201)
{
  "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
}
Response examples (409)
{
  "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"
}