---
title: "Create a user (deprecated — use /users/invite)"
method: POST
path: "/users"
tags: ["users"]
---

# Create a user (deprecated — use /users/invite)

`POST /users`

**Deprecated** — Use `/users/invite` instead.

Creates a new user from their email address and phone number (E.164 format). An invitation email is sent and the user must confirm their account to log in to Ringover.

**Permission:** `Users Write` required.

**Monitoring:** Not needed.

## Request body

- NewUser
  - `email` string
  - `number` integer — Phone number (E.164 format)
  - `commitment` boolean — (optional) with or without commitment

## Response `200`

Successful operation

## Other responses

- `400` — The request body is malformed or missing required fields (email, phone number)
- `401` — Authentication token is missing, invalid, expired, or Users Write permission is missing
- `500` — Internal server error
- `502` — Service temporarily unavailable

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)