Create an API Client

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-v81/mcp

Standard setup for AI tools providing an mcp.json file

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

Close
POST /profiles/{profile_id}/api_clients

Creates a client acting as user_id, a user of the profile. type is a non-empty list of jwt-bearer, authorization_code, password. redirect_uris is required when type includes authorization_code; each entry must be an absolute http(s) URL without fragment or whitespace, and the list joined by commas must fit 200 characters.

The response carries client_secret once. Store it: no later request returns it, and reset_secret replaces it.

Path parameters

  • profile_id string Required

    id of the profile

application/json

Body Required

  • name string Required

    Maximum length is 100.

  • user_id integer Required

    id of the user the client acts as; must belong to profile_id

  • type array[string] Required

    At least 1 element. Values are jwt-bearer, authorization_code, or password.

  • redirect_uris array[string(uri)]

Responses

  • 201 application/json

    Created - the secret is in this response only.

    Hide response attributes Show response attributes object
    • id integer
    • client_key string
    • client_secret string
  • 400

    Bad Request - name is missing, over 100 characters or a reserved name (TASKWORKER, PUBLICLINKAPI, FLATTENTASKAPI), type is empty or names an unknown grant, redirect_uris holds a value that is not an absolute http(s) URL without fragment or whitespace or the list joined by commas exceeds 200 characters, redirect_uris is empty while type includes authorization_code, or user_id is not a user of the profile (for a COMPANY caller, also when that user is a server admin or a group).

  • 401

    Unauthorized - missing or invalid bearer token.

  • 403

    Forbidden - the token belongs to a BASIC user, or profile_id is not the caller's own profile.

  • 404

    Not Found - profile_id is not a valid profile id.

POST /profiles/{profile_id}/api_clients
curl \
 --request POST 'https://api.iformbuilder.com/exzact/api/v81/[servername]/profiles/self/api_clients' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "name": "Field app",
  "user_id": 161236,
  "type": [
    "jwt-bearer",
    "authorization_code"
  ],
  "redirect_uris": [
    "https://app.example.com/oauth/callback"
  ]
}'
Request example
{
  "name": "Field app",
  "user_id": 161236,
  "type": [
    "jwt-bearer",
    "authorization_code"
  ],
  "redirect_uris": [
    "https://app.example.com/oauth/callback"
  ]
}
Response examples (201)
{
  "id": 16,
  "client_key": "3f1c9b7e2a4d5c6f8e9a0b1c2d3e4f5a6b7c8d9e",
  "client_secret": "7a6b5c4d3e2f1a0b9c8d7e6f5a4b3c2d1e0f9a8b"
}