123FormBuilder · Capability

123FormBuilder REST API v2 — Users & Accounts

Combined administrative surface for managing subusers (with fine-grained permission flags) and provisioning/updating billable 123FormBuilder accounts. Also includes the Login flow (token, refresh, invalidate) that issues the JWT used by every other capability.

Run with Naftiko 123FormBuilderUsersAccountsLogin

What You Can Do

POST
Login — User Login
/v2/token
POST
Refreshtoken — Refresh Token
/v2/token/refresh
POST
Invalidatetoken — Invalidate Token
/v2/token/invalidate
GET
Listusers — Get Info About Master User and Subusers
/v2/users
POST
Createuser — Create a New Subuser
/v2/users
PUT
Updateuser — Update User
/v2/users/{identifier}
POST
Createaccount — Create New Account
/v2/accounts
PUT
Updateaccount — Update Account
/v2/accounts/{user_id}

MCP Tools

123formbuilder-login

User Login

123formbuilder-refresh-token

Refresh Token

123formbuilder-invalidate-token

Invalidate Token

idempotent
123formbuilder-list-users

Get Info About Master User and Subusers

read-only idempotent
123formbuilder-create-user

Create a New Subuser

123formbuilder-update-user

Update User

idempotent
123formbuilder-create-account

Create New Account

123formbuilder-update-account

Update Account

idempotent

Capability Spec

users-accounts.yaml Raw ↑ 
naftiko: 1.0.0-alpha2
info:
  label: 123FormBuilder REST API v2 — Users & Accounts
  description: |
    Combined administrative surface for managing subusers (with fine-grained permission flags)
    and provisioning/updating billable 123FormBuilder accounts. Also includes the Login flow
    (token, refresh, invalidate) that issues the JWT used by every other capability.
  tags:
    - 123FormBuilder
    - Users
    - Accounts
    - Login
  created: '2026-05-28'
  modified: '2026-05-28'
binds:
  - namespace: env
    keys:
      ONE_TWO_THREE_FORMBUILDER_JWT: ONE_TWO_THREE_FORMBUILDER_JWT
      ONE_TWO_THREE_FORMBUILDER_USERNAME: ONE_TWO_THREE_FORMBUILDER_USERNAME
      ONE_TWO_THREE_FORMBUILDER_PASSWORD: ONE_TWO_THREE_FORMBUILDER_PASSWORD
capability:
  consumes:
    - type: http
      namespace: 123formbuilder-admin
      baseUri: https://api.123formbuilder.com
      description: 123FormBuilder Users, Accounts, and Login operations.
      resources:
        - name: v2-token
          path: /v2/token
          operations:
            - name: login
              method: POST
              description: User Login
              outputRawFormat: json
              inputParameters:
                - name: username
                  in: query
                  type: string
                  required: false
                - name: email
                  in: query
                  type: string
                  required: false
                - name: password
                  in: query
                  type: string
                  required: false
                - name: passhash
                  in: query
                  type: string
                  required: false
        - name: v2-token-refresh
          path: /v2/token/refresh
          operations:
            - name: refreshtoken
              method: POST
              description: Refresh Token
              outputRawFormat: json
              inputParameters:
                - name: body
                  in: body
                  type: object
                  required: true
        - name: v2-token-invalidate
          path: /v2/token/invalidate
          operations:
            - name: invalidatetoken
              method: POST
              description: Invalidate Token
              outputRawFormat: json
              inputParameters:
                - name: body
                  in: body
                  type: object
                  required: true
        - name: v2-users
          path: /v2/users
          operations:
            - name: listusers
              method: GET
              description: Get Info About Master User and Subusers
              outputRawFormat: json
              inputParameters:
                - name: JWT
                  in: query
                  type: string
                  required: true
                - name: per_page
                  in: query
                  type: integer
                  required: false
                - name: page
                  in: query
                  type: integer
                  required: false
            - name: createuser
              method: POST
              description: Create a New Subuser
              outputRawFormat: json
              inputParameters:
                - name: body
                  in: body
                  type: object
                  required: true
        - name: v2-users-identifier
          path: /v2/users/{identifier}
          operations:
            - name: updateuser
              method: PUT
              description: Update User
              outputRawFormat: json
              inputParameters:
                - name: identifier
                  in: path
                  type: string
                  required: true
                - name: body
                  in: body
                  type: object
                  required: true
        - name: v2-accounts
          path: /v2/accounts
          operations:
            - name: createaccount
              method: POST
              description: Create New Account
              outputRawFormat: json
              inputParameters:
                - name: body
                  in: body
                  type: object
                  required: true
        - name: v2-accounts-id
          path: /v2/accounts/{user_id}
          operations:
            - name: updateaccount
              method: PUT
              description: Update Account
              outputRawFormat: json
              inputParameters:
                - name: user_id
                  in: path
                  type: integer
                  required: true
                - name: body
                  in: body
                  type: object
                  required: true
  exposes:
    - type: rest
      namespace: 123formbuilder-admin-rest
      port: 8080
      resources:
        - name: v2-token
          path: /v2/token
          operations:
            - method: POST
              name: login
              description: User Login
              call: 123formbuilder-admin.login
        - name: v2-token-refresh
          path: /v2/token/refresh
          operations:
            - method: POST
              name: refreshtoken
              description: Refresh Token
              call: 123formbuilder-admin.refreshtoken
        - name: v2-token-invalidate
          path: /v2/token/invalidate
          operations:
            - method: POST
              name: invalidatetoken
              description: Invalidate Token
              call: 123formbuilder-admin.invalidatetoken
        - name: v2-users
          path: /v2/users
          operations:
            - method: GET
              name: listusers
              description: Get Info About Master User and Subusers
              call: 123formbuilder-admin.listusers
            - method: POST
              name: createuser
              description: Create a New Subuser
              call: 123formbuilder-admin.createuser
        - name: v2-users-identifier
          path: /v2/users/{identifier}
          operations:
            - method: PUT
              name: updateuser
              description: Update User
              call: 123formbuilder-admin.updateuser
        - name: v2-accounts
          path: /v2/accounts
          operations:
            - method: POST
              name: createaccount
              description: Create New Account
              call: 123formbuilder-admin.createaccount
        - name: v2-accounts-id
          path: /v2/accounts/{user_id}
          operations:
            - method: PUT
              name: updateaccount
              description: Update Account
              call: 123formbuilder-admin.updateaccount
    - type: mcp
      namespace: 123formbuilder-admin-mcp
      port: 9090
      transport: http
      tools:
        - name: 123formbuilder-login
          description: User Login
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: 123formbuilder-admin.login
        - name: 123formbuilder-refresh-token
          description: Refresh Token
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: 123formbuilder-admin.refreshtoken
        - name: 123formbuilder-invalidate-token
          description: Invalidate Token
          hints:
            readOnly: false
            destructive: true
            idempotent: true
          call: 123formbuilder-admin.invalidatetoken
        - name: 123formbuilder-list-users
          description: Get Info About Master User and Subusers
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: 123formbuilder-admin.listusers
        - name: 123formbuilder-create-user
          description: Create a New Subuser
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: 123formbuilder-admin.createuser
        - name: 123formbuilder-update-user
          description: Update User
          hints:
            readOnly: false
            destructive: false
            idempotent: true
          call: 123formbuilder-admin.updateuser
        - name: 123formbuilder-create-account
          description: Create New Account
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: 123formbuilder-admin.createaccount
        - name: 123formbuilder-update-account
          description: Update Account
          hints:
            readOnly: false
            destructive: false
            idempotent: true
          call: 123formbuilder-admin.updateaccount