---
title: "Criar E-mail"
method: POST
path: "/emails"
---

# Criar E-mail

`POST /emails`

## Request

- Base URL: `https://api.iugu.com/v1`
- URL: `https://api.iugu.com/v1/emails`
- Auth: API key in query parameter `api_token`

## Request body

- object
  - `identifier` string, required: Identificador do email (Deve ser enviado um dos itens retornados pela API de 'Listar Emails Disponíveis')
  - `template` string, required: Template do email
  - `subject` string, required: Assunto do email
  - `active` boolean, required: Determina se o email ficará ativo ou não logo após a criação

## Response `200`

200

- object
  - `id` string
  - `identifier` string
  - `template` string
  - `subject` string
  - `active` boolean

## Other responses

- `400`: 400
- `422`: 422

---

[API](https://skmtc.dev/iugu/apis/emails-transacionais.md) - [All operations](https://skmtc.dev/iugu/apis/emails-transacionais/llms.txt) - [OpenAPI document](https://skmtc.dev/iugu/apis/emails-transacionais/revisions/58653790a455?raw)