# Create an account

Creates an account.

Endpoint: POST /v3/accounts
Version: 2026-01-08
Security: ZephrHmacHttp

## Request fields (application/json):

  - `company_id` (string)
    Example: "123456789ABCD"

  - `name` (string)
    Example: "Account name"

  - `number_of_seats` (number)
    Example: 5

  - `allow_oversubscription` (boolean)
    Example: true

  - `notify_when_account_oversubscribed` (boolean)
    Example: true

  - `notify_on_each_registration_when_account_is_oversubscribed` (boolean)
    Example: true

  - `registration_code` (string)
    Example: "Registration code"

  - `on_premises_ips` (string)
    A list of newline-separated IP addresses or CIDR blocks that identify the premises associated with this account.
    Example: "125.124.143.24"

  - `premises_tags` (string)
    (string) A JSON array of strings of 'tags'. Tags can be used to identify and group accounts to drive behaviour in the Zephr decision engine.
    Example: "[\"gold-tier\", \"university\"]"

  - `session_limit` (number)
    The maximum number of concurrent sessions that users of this account can have. If unspecified, the system default value is used. If a user belongs to multiple accounts, the highest limit is used.
    Example: 10

  - `session_limit_behaviour` (string)
    One of "PREVENT_LOGIN" or "DELETE_OLDEST_SESSIONS". Specifies the behaviour when a user of this account exceeds the configured limit of concurrent sessions.
    Example: "PREVENT_LOGIN"


## Response 201 fields

## Response 400 fields