---
title: "Bulk Create Users"
method: POST
path: "/users:bulk-create"
tags: ["users"]
---

# Bulk Create Users

`POST /users:bulk-create`

## Request

- Base URL: `https://{tenant_name}.benchling.com/api/v2`
- URL: `https://{tenant_name}.benchling.com/api/v2/users:bulk-create`
- Auth: HTTP bearer

Bulk Create Users.

## Request body

- UserBulkCreateRequest
  - `users` UserCreate[]
    - `email` string, required: Email of the User
    - `handle` string, required: Handle of the User
    - `name` string, required: Name of the User

## Response `202`

This endpoint launches a [long-running task](https://docs.benchling.com/docs/api/v2/benchling-api/tasks/get-task) and returns the Task ID of the launched task.
When successful, the task returns a full list of [Users](https://docs.benchling.com/docs/api/v2/benchling-api/users/bulk-create-users) resources that were created.

- AsyncTaskLink
  - `taskId` string

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/benchling/apis/benchling-api-2.md) - [All operations](https://skmtc.dev/benchling/apis/benchling-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/benchling/apis/benchling-api-2/revisions/01d2fa8523cd?raw)
