> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gu1.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Exportação em massa de entidades por e-mail

> Enfileira um job assíncrono que exporta entidades filtradas para CSV, XLSX ou JSON e entrega o arquivo resultante por e-mail ao destinatário.

## Visão geral

Exporta entidades com os **mesmos filtros de `GET /entities`**, gera um arquivo (`csv`, `xlsx` ou `json`) e entrega por e-mail. Resposta **202** com `jobId`; consulte `GET /entities/export/jobs/{jobId}`.

## Endpoint

```
POST http://api.gu1.ai/entities/export/jobs
```

## Autenticação, permissões e marketplace

Igual a [Relatório PDF por e-mail](/pt/api-reference/entities/report-export-email): `Authorization`, `X-Organization-ID`, **`entities:export`**, **`global_sender_email`**, cobrança **por destinatário**.

## Domínio e remetente

* **`fromEmail`**: domínio **verificado**; remetente cadastrado não é obrigatório.
* **`fromSenderId`**: UUID em `organization_email_senders`.
* Não enviar os dois juntos.

## Corpo JSON

<ParamField body="recipientEmails" type="string[]" required>
  Destinatários (máx. **26** deduplicados). Somente esses endereços.
</ParamField>

<ParamField body="format" type="string" required>
  `csv`, `xlsx` ou `json`.
</ParamField>

<ParamField body="filters" type="object">
  Mesma forma dos filtros de `GET /entities`. Padrão `{}`.
</ParamField>

<ParamField body="emailLocale" type="string">
  `en`, `es` ou `pt`.
</ParamField>

<ParamField body="columns" type="string[]">
  Colunas snake\_case opcionais; omitir = todas permitidas.
</ParamField>

<ParamField body="fromSenderId" type="string (uuid)">
  Remetente por UUID. Exclusivo com `fromEmail`.
</ParamField>

<ParamField body="fromEmail" type="string">
  Remetente em domínio verificado. Exclusivo com `fromSenderId`.
</ParamField>

### Exemplo

```json theme={null}
{
  "recipientEmails": ["analista@exemplo.com"],
  "format": "csv",
  "emailLocale": "pt",
  "fromEmail": "exportacoes@seu-dominio.com",
  "filters": {}
}
```

## Resposta 202

```json theme={null}
{
  "jobId": "uuid-do-job",
  "message": "…"
}
```

## Acompanhamento

* `GET /entities/export/jobs/{jobId}` — status.
* E-mail de conclusão pode incluir link assinado.

## Erros 400

Mesmos códigos de [report-export-email](/pt/api-reference/entities/report-export-email).

## Relacionado

* [Relatório PDF por e-mail](/pt/api-reference/entities/report-export-email).