---
title: "Create Test User Batch"
method: POST
path: "/v1/admin/test-users/batches"
tags: ["admin", "test-users", "Admin - Generated Users"]
---

# Create Test User Batch

`POST /v1/admin/test-users/batches`

## Request body

- TestUserBatchCreate
  - `name` string, required
  - `count` integer, required
  - `initial_credits` number, nullable — Deprecated: the selected plan determines the initial balance
  - `subscription_plan_id` integer, nullable
  - `include_kodik` boolean
  - `include_batch_name` boolean
  - `separator` '-' | '_' | ''

## Response `201`

Successful Response

- TestUserBatchCreateResponse
  - `batch` TestUserBatchSummary, required
    - `batch_key` string, required
    - `name` string, required
    - `created_count` integer, required
    - `created_at` string, date-time, required
    - `last_created_at` string, date-time, required
  - `credentials` TestUserCredential[], required
    - `user_id` integer, required
    - `email` string, required
    - `password` string, required
    - `credits_balance` number, required
  - `failures` TestUserCreationFailure[], required
    - `email` string, required
    - `detail` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/kodik/apis/kodik-api.md) · [All operations](https://skmtc.dev/kodik/apis/kodik-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kodik/kodik-api/revisions/55c71b347360/schema)