# Add batch recipients (CSV)

Replaces the recipient list of an editable batch with a raw CSV upload. Send exactly `Content-Type: text/csv` without media-type parameters. Send the CSV in UTF-8. The CSV supports up to 100,000 recipients and uses `;` as the column separator. Mandatory columns: `emailaddress`, `legalname`. Optional columns: `lookupkey`, `displayname`, `evidenceaccesscontrolchallenge`, `evidenceaccesscontrolchallengeresponse`. Custom per-recipient fields are added as extra columns prefixed with `*` (for example, `*orderid`).

Endpoint: POST /v2/EviMail/Batches/{BatchId}/Recipients
Version: 1.0
Security: basicAuth

## Security:

  - `basicAuth` (unknown)
    http basic

## Path parameters:

  - `BatchId` (string, required)

## Response 200:

  - `200` (unknown)
    CSV stored. The batch worker validates recipient rows after submission and can mark the batch Invalid. No response body is returned.

## Response 400:

  - `400` (unknown)
    Batch is not editable, CSV validation failed, or the content type or encoding is invalid.

## Response 401:

  - `401` (unknown)
    Authentication failed

## Response 404:

  - `404` (unknown)
    No batch with the given BatchId was found.

## Response 415:

  - `415` (unknown)
    The server rejected the request media type. Some deployments return HTTP 400 for this case.

