# Create an SMS batch

Creates a new, empty SMS batch. Only a `Description` is required at creation; the message text, recipients, and options are set with the subsequent batch endpoints. Returns the `BatchId` used by all other batch operations.

Endpoint: POST /v2/EviSms/Batches
Version: 1.0
Security: basicAuth

## Security:

  - `basicAuth` (unknown)
    http basic

## Request fields (application/json):

  - `Description` (string, required)
    Human-readable description of the batch.

## Response 201:

  - `201` (unknown)
    Batch created.

## Response 201 fields (application/json):

  - `BatchId` (string)
    Unique identifier of the created batch. Use it in all other batch operations.

## Response 202:

  - `202` (unknown)
    On ASP.NET, an idempotent replay returns the previously stored batch result.

## Response 202 fields (application/json):

  - `BatchId` (string)
    Unique identifier of the created batch. Use it in all other batch operations.

## Response 401:

  - `401` (unknown)
    Authentication failed

## Response 403:

  - `403` (unknown)
    The site does not use by-submission billing or the account lacks the batch sender role.

## Response 500:

  - `500` (unknown)
    Internal server error

