Create a business batch

POST

https://api.middesk.com/v1/business_batches

POST

/v1/business_batches

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

1 {
2   "object": "business_batch",
3   "id": "e1f2a3b4-c5d6-7890-4567-89abcdef0123",
4   "name": "Q1-2025-Verification-Batch",
5   "filename": "businesses.csv",
6   "business_count": 1,
7   "completed_business_count": 0,
8   "created_at": "2025-01-07T12:00:00.000Z",
9   "account": {
10     "id": "f2a3b4c5-d6e7-8901-5678-9abcdef01234",
11     "name": "Example Account",
12     "slug": "example-account",
13     "pilot": false
14   }
15 }

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

Errors

400

Create Business Batch Request Bad Request Error

422

Create Business Batch Request Unprocessable Entity Error