---
title: "Provision New User"
method: POST
path: "/api/v1/internal/provision-new-user"
tags: ["internal"]
---

# Provision New User

`POST /api/v1/internal/provision-new-user`

Bootstrap tenancy for a freshly-created ``auth.user``.

The body is the same bytes the front signed — we re-parse them with
Pydantic here rather than declaring ``body: ProvisionNewUserRequest``
on the signature because FastAPI would otherwise read the request
stream before the HMAC dep gets a chance, leaving the dep with an
empty body to hash.

## Response `200`

Successful Response

- ProvisionNewUserResponse — Echoed for debugging only — front-end ignores the body.
  - `user_id` string, uuid, required
  - `default_company_id` string, uuid, required
  - `phase` string, required — Which provisioning branch was taken: scim | invitation | personal

---

[API](https://skmtc.net/netter/apis/dmi-backend.md) · [All operations](https://skmtc.net/netter/apis/dmi-backend/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netter/dmi-backend/versions/a59877bf911b/schema)