---
title: "Create User"
method: POST
path: "/users"
tags: ["Users", "users"]
---

# Create User

`POST /users`

## Request

- Base URL: `https://api.fonestorm.com/v2`
- URL: `https://api.fonestorm.com/v2/users`
- Auth: API key in header `token`

Add a new User to an account.

## Request body

- object
  - `email` string, required: User email address
  - `dashboard_role` 'None' | 'Location' | 'Organization' | 'Agent' | 'Master': User Role.
  - `dashboard_access` 'None' | 'User' | 'Manager' | 'Administrator' | 'Custom': User access
  - `first_name` string: User First Name
  - `last_name` string: User Last Name
  - `title` string: User Title
  - `fractelfone` string: FracTELfone device id
  - `subaccount` string: User subaccount id
  - `custom_access` object: Custom access options
    - `subaccounts` 'None' | 'Read' | 'Edit' | 'Add': Subaccount access options
    - `users` 'None' | 'Read' | 'Edit' | 'Add' | 'Remove': Users access options
    - `business_objects` 'None' | 'Read' | 'Edit' | 'Add' | 'Remove': Business Object access options
    - `fonenumbers` 'None' | 'Read' | 'Edit' | 'Add' | 'Remove': FoneNumbers access options
    - `billing` 'None' | 'Read': Billing access options
    - `call_records` 'None' | 'Read': Call Records access options

## Response `201`

Created

- object
  - `user` User
    - `email` string: Email address.
    - `dashboard_role` 'None' | 'Location' | 'Organization' | 'Agent' | 'Master': User Role.
    - `dashboard_access` 'None' | 'User' | 'Manager' | 'Administrator' | 'Custom': User access
    - `first_name` string: User First Name
    - `last_name` string: User Last Name
    - `title` string: User Title
    - `fractelfone` string: FracTELfone device id
    - `account_id` string: User account id
    - `custom_access` object: Custom access options
      - `subaccounts` 'None' | 'Read' | 'Edit' | 'Add': Subaccount access options
      - `users` 'None' | 'Read' | 'Edit' | 'Add' | 'Remove': Users access options
      - `business_objects` 'None' | 'Read' | 'Edit' | 'Add' | 'Remove': Business Object access options
      - `fonenumbers` 'None' | 'Read' | 'Edit' | 'Add' | 'Remove': FoneNumbers access options
      - `billing` 'None' | 'Read': Billing access options
      - `call_records` 'None' | 'Read': Call Records access options

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `default`: Error

---

[API](https://skmtc.dev/fonestorm/apis/fractel-api-2-12-87c-hail.md) · [All operations](https://skmtc.dev/fonestorm/apis/fractel-api-2-12-87c-hail/llms.txt) · [OpenAPI document](https://skmtc.dev/fonestorm/apis/fractel-api-2-12-87c-hail/revisions/9738d9b806d4?raw)