---
title: "Envio em Lote (arquivo CSV/XLSX)"
method: POST
path: "/api/v2/batches"
tags: ["E-mails em Lote"]
---

# Envio em Lote (arquivo CSV/XLSX)

`POST /api/v2/batches`

Cria um lote a partir de um arquivo **CSV / TXT / XLS / XLSX** enviado como `multipart/form-data`. Cada coluna do arquivo e associada a um campo pelo `mapping` (indice da coluna, base 0).

**Autenticacao:** token de **usuario**.

**Campos do formulario:**
- `datafile` (file) - o arquivo. Ate 40MB / 140000 itens.
- `batch_name` (text) - obrigatorio.
- `template_id` (text) - obrigatorio (template ativo).
- `mapping` (text, JSON) - mapeia campo -> indice da coluna. Deve conter no minimo `destinatario` e `assunto`, alem de todas as variaveis do template. Ex.: {"destinatario": 0, "assunto": 1, "nome": 2, "responder": 3, "assinar": 4}
- `has_header` (text) - `1`/`true` se a primeira linha for cabecalho (default: true).
- `delimiter` (text) - separador de colunas do CSV (default: `,`).

**Alternativa JSON (base64):** os mesmos dados podem ser enviados como JSON com o arquivo em base64 no campo `batch_file`, mais `filename`, `mapping`, `header`, `delimiter`, `batch_name` e `template_id`.

As colunas `responder` e `assinar` sao opcionais e tem o mesmo significado do modo JSON.

## Response `202`

Accepted

- object

---

[API](https://skmtc.net/bry/apis/bry-easy-sign-api-rest.md) · [All operations](https://skmtc.net/bry/apis/bry-easy-sign-api-rest/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bry/bry-easy-sign-api-rest/revisions/c87e026e87ac/schema)