---
title: "Distributor View Create Team Users"
method: POST
path: "/api/v1/distributor/team/users"
tags: ["User APIs", "distributor-view"]
---

# Distributor View Create Team Users

`POST /api/v1/distributor/team/users`

Seat brand new users on the distributor's own client, each with a
distributor role.

The grant endpoint above can only reach users who already exist, which is a
dead end for a distributor whose every user already holds a role. This one
provisions the accounts.

Every row is checked before anything is created: neither Okta nor the users
table rolls back, so a bad role or an address already in use has to fail
the batch while it is still cost-free to fail.

## Request body

- DistributorViewTeamUserBulkCreate — A batch of new users for the distributor client. Duplicate addresses inside one batch are rejected rather than collapsed — two rows sharing an address means the caller mistyped one of them, and quietly dropping a row would seat fewer people than the form showed.
  - `users` DistributorViewTeamUserCreate[], required
    - `first_name` string, required
    - `last_name` string, required
    - `email` string, required
    - `distributor_role` string, required
    - `prompt_access` boolean

## Response `201`

Successful Response

- DistributorViewTeamUserBulkResult — Outcome of a batch. ``created`` holds the seated users; ``skipped`` names any address the batch could not seat, with the reason.
  - `created` DistributorViewTeamMember[], required
    - `id` string, uuid, required
    - `first_name` string, required
    - `last_name` string, required
    - `email` string, required
    - `distributor_role` string, required
    - `status` string
    - `prompt_access` boolean
  - `skipped` DistributorViewSkippedEmail[]
    - `email` string, required
    - `reason` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-client-admin-api/revisions/a8ca30023371/schema)