---
title: "Create a user"
method: POST
path: "/v1/companies/{company_code_or_sid}/users"
tags: ["users", "companies"]
---

# Create a user

`POST /v1/companies/{company_code_or_sid}/users`

Create a user for log-in for this Company

## Path parameters

- `company_code_or_sid` string, required

## Request body

- StreemApiCreateCompanyUserRequest
  - `email` string
  - `name` string
  - `user_type` 'USER_TYPE_UNSPECIFIED' | 'USER_TYPE_LOGIN' | 'USER_TYPE_SDK' | 'USER_TYPE_INVITED'
  - `groups` string[]
  - `bio` string

## Response `201`

Created the User

- StreemApiCreateCompanyUserResponse
  - `user` StreemApiUser
    - `sid` string
    - `company_sid` string
    - `external_user_id` string
    - `is_expert` boolean
    - `email` string
    - `name` string
    - `avatar_url` string
    - `phone` string
    - `active` boolean
    - `roles` string[]
    - `active_status_modified_at` string, date-time
    - `user_types` string[]
    - `deleted` boolean
    - `deleted_at` string, date-time
    - `bio` string
    - `availability_status` 'AVAILABILITY_STATUS_AVAILABLE' | 'AVAILABILITY_STATUS_NOT_AVAILABLE' | 'AVAILABILITY_STATUS_RESERVED' | 'AVAILABILITY_STATUS_IN_CALL' | 'AVAILABILITY_STATUS_CONFIRMING' | 'AVAILABILITY_STATUS_OFFLINE' | 'AVAILABILITY_STATUS_INVALID'

## Other responses

- `400` — Email is required
- `403` — Not allowed to create a user
- `404` — Could not find the company
- `409` — Conflict on user creation, either with email or user id.
- `500` — Internal Server Error, unable to create user

---

[API](https://skmtc.net/streem/apis/streem-api.md) · [All operations](https://skmtc.net/streem/apis/streem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/streem/streem-api/versions/04250faebd19/schema)