Create a business batch

curl -X POST https://api.middesk.com/v1/business_batches \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Q1-2025-Verification-Batch",
  "filename": "businesses.csv",
  "csv": "bmFtZSxhZGRyZXNzX2xpbmUxLGFkZHJlc3NfY2l0eSxhZGRyZXNzX3N0YXRlCkFjbWUgQ29ycG9yYXRpb24sMTIzIE1haW4gU3RyZWV0LFNhbiBGcmFuY2lzY28sQ0EK"
}'

{
  "object": "business_batch",
  "id": "e1f2a3b4-c5d6-7890-4567-89abcdef0123",
  "name": "Q1-2025-Verification-Batch",
  "filename": "businesses.csv",
  "business_count": 1,
  "completed_business_count": 0,
  "created_at": "2025-01-07T12:00:00Z",
  "account": {
    "id": "f2a3b4c5-d6e7-8901-5678-9abcdef01234",
    "name": "Example Account",
    "slug": "example-account",
    "pilot": false
  }
}

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

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

namestringRequired

Name for the business batch

filenamestringRequired

CSV filename

csvstringRequired

Base64 encoded CSV data

Response

business batch created

objectstring

idstringformat: "uuid"

namestring

filenamestring

business_countinteger>=0

completed_business_countinteger

created_atdatetime

accountobject

Errors

400

Create Business Batch Request Bad Request Error

422

Create Business Batch Request Unprocessable Entity Error

429

Create Business Batch Request Too Many Requests Error

503

Create Business Batch Request Service Unavailable Error