---
title: "Create User Batch"
method: POST
path: "/v1/user/batch"
tags: ["v1", "User"]
---

# Create User Batch

`POST /v1/user/batch`

Create multiple users or link existing users to developer, and add each to the developer's workspace (if one exists).

## Headers

- `X-API-Key` string, required

## Request body

- BatchUserCreateRequest
  - `users` CreateUserRequest[], required
    - `email` string, email, nullable
    - `external_id` string, required
    - `metadata` object, nullable
    - `type` 'developerUser' | 'user' | 'agent'

## Response `200`

Successful Response

- UserListResponse
  - `code` integer, required — HTTP status code
  - `status` string, required — 'success' or 'error'
  - `data` UserResponse[], nullable
    - `code` integer, required — HTTP status code
    - `status` string, required — 'success' or 'error'
    - `user_id` string, nullable
    - `email` string, nullable
    - `external_id` string, nullable
    - `metadata` object, nullable
    - `created_at` string, nullable
    - `updated_at` string, nullable
    - `error` string, nullable
    - `details` unknown
  - `total` integer, nullable
  - `page` integer, nullable
  - `page_size` integer, nullable
  - `error` string, nullable
  - `details` unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/papr-ai/apis/papr-memory-api.md) · [All operations](https://skmtc.net/papr-ai/apis/papr-memory-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/papr-ai/papr-memory-api/revisions/b553be9aad37/schema)