---
title: "POST api/users"
method: POST
path: "/api/users"
tags: ["User"]
---

# POST api/users

`POST /api/users`

## Request

- Base URL: `https://app.followr.ai`
- URL: `https://app.followr.ai/api/users`
- Auth: HTTP bearer

Create a new user, if user already exists, it will be attached to the company provided with an invitation

## Request body

- object
  - `name` string: The name of the user
  - `email` string: The email of the user
  - `company_id` string: The ID of the company
  - `language` string: language of the user
  - `timezone` string: timezone of the user
  - `referrer_url` string: Must be a valid URL. Must not be greater than 255 characters.
  - `land_url` string: Must be a valid URL. Must not be greater than 255 characters.
  - `role` string: role of the user in the company ~owner, admin, user, client~, default: user

## Response `200`

- object
  - `data` object
    - `id` integer
    - `name` string
    - `email` string
    - `referral_code` string
    - `language` string
    - `timezone` string
    - `notification_settings` string
    - `credits` integer
    - `pm_type` string
    - `pm_last_four` string
    - `cancel_reason` string
    - `referrer_url` string
    - `land_url` string
    - `has_password` boolean
    - `created_at` string
    - `updated_at` string
    - `banned_at` string
    - `password_changed_at` string

---

[API](https://skmtc.dev/followr/apis/followr-api-documentation.md) - [All operations](https://skmtc.dev/followr/apis/followr-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/followr/apis/followr-api-documentation/revisions/df7f1bbefd95?raw)