---
title: "New user"
method: POST
path: "/users"
---

# New user

`POST /users`

Create a whitelabel account.

## Request body

- object
  - `email` string, email, required — The email address of the user to create an account for; the address is case insensitive and can be in any character encoding.
  - `credits` integer — The number of API credits to preload the account with.

## Response `201`

The new account metadata.

- object
  - `email` string, email, required — The email address of the new account as recorded by the API.
  - `token` string, required — The bearer token issued to the account for authentication.
  - `credits` integer, required — The number of initial credits granted to the account.

## Other responses

- `400` — The request was malformed.
- `401` — The authorization header was missing.
- `403` — The API token was invalid.
- `409` — One or more resources already exists.
- `422` — One or more parameters were invalid.
- `429` — The rate limit was exceeded.
- `500` — An unknown error occurred.

## Changes

> 9 revisions in range; 1 could not be searched.

- **2026-07-06** `bfddf5b2c698` — 1 warning
  - the `email` request property's maxLength was set to `255`
- **2026-06-29** `bbfea328162f` — 1 info
  - added the required property `credits` to the response with the `201` status

[Change history](https://skmtc.dev/joinmassive/apis/massive/changes/users/post.md)

---

[API](https://skmtc.dev/joinmassive/apis/massive.md) · [All operations](https://skmtc.dev/joinmassive/apis/massive/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/joinmassive/massive/revisions/3a9f7769563f/schema)