---
title: "Create a business batch"
method: POST
path: "/v1/business_batches"
tags: ["businessBatches"]
---

# Create a business batch

`POST /v1/business_batches`

Each CSV row consumes one business creation from the Sandbox account limit.

## Headers

- `Authorization` string, required

## Request body

- object
  - `name` string, required — Name for the business batch
  - `filename` string, required — CSV filename
  - `csv` string, required — Base64 encoded CSV data

## Response `200`

business batch created

- TypeBusinessBatch
  - `object` string, required
  - `id` string, uuid, required
  - `name` string, required
  - `filename` string, required
  - `business_count` integer, required
  - `completed_business_count` integer, required
  - `created_at` string, date-time, required
  - `account` TypeBusinessBatchAccount, required
    - `id` string, uuid, required
    - `name` string, required
    - `slug` string, required
    - `pilot` boolean, required

## Other responses

- `400` — invalid request
- `422` — validation errors
- `429` — Sandbox fixed one-minute account business-creation limit exceeded
- `503` — Sandbox business creation rate limit service unavailable

---

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