# Create a Batch Message

Create a Batch Message

Endpoint: POST /v1/batch_message
Version: 1.0.0
Security: apiKeyAuth, practiceGroupId

## Request fields (application/json):

  - `name` (string, required)

  - `channel` (string, required)
    Enum: "SMS", "EMAIL", "NHS_APP"

  - `subject` (string)
    The subject is required when channel = EMAIL

  - `content` (string, required)

  - `recipients` (array, required)

## Response 200 fields (application/json):

  - `id` (string, required)

  - `name` (string, required)

  - `status` (string, required)
    Enum: "CREATED", "PENDING", "SENDING", "COMPLETED"

  - `channel` (string, required)
    Enum: "SMS", "EMAIL", "NHS_APP"

  - `subject` (string)

  - `content` (string, required)

## Response 400 fields (application/json):

  - `error` (boolean, required)

  - `statusCode` (number, required)

  - `message` (array, required)

  - `message.code` (string, required)

  - `message.expected` (string, required)

  - `message.path` (array, required)


## Response 401 fields

## Response 404 fields

## Response 500 fields