Skip to main content
POST
/
v1
/
email
/
messages
Enviar e-mail(s)
curl --request POST \
  --url https://api.notifique.dev/v1/email/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from": "noreply@seudominio.com",
  "fromName": "Suporte",
  "to": [
    "cliente@example.com"
  ],
  "subject": "Confirmação de pedido",
  "html": "<p>Olá, seu pedido foi confirmado.</p>",
  "schedule": {
    "sendAt": "2025-12-31T14:00:00.000Z"
  },
  "options": {
    "priority": "normal"
  }
}
'
{
  "success": true,
  "data": {
    "emailIds": [
      "clxx123...",
      "clxx456..."
    ],
    "status": "QUEUED",
    "count": 2
  }
}

Authorizations

Authorization
string
header
required

API Key no header Authorization. Exemplo: Authorization: Bearer sk_live_xxxxx

Headers

Idempotency-Key
string

Chave única para evitar envio duplicado. Alternativa: x-idempotency-key.

x-idempotency-key
string

Chave única para idempotência (alternativa a Idempotency-Key).

Body

application/json

Pelo menos um de text ou html é obrigatório.

from
string
required

Endereço do remetente (ex.: noreply@seudominio.com). O domínio deve estar verificado no workspace.

Minimum string length: 1
to
string[]
required

Lista de endereços de e-mail dos destinatários. Um e-mail por endereço.

Required array length: 1 - 100 elements
Minimum string length: 1
subject
string
required

Assunto do e-mail.

Required string length: 1 - 998
fromName
string

Nome exibido do remetente (opcional).

text
string

Corpo em texto plano. Obrigatório se html não for informado.

Maximum string length: 500000
html
string

Corpo em HTML. Obrigatório se text não for informado.

Maximum string length: 500000
schedule
object
options
object

Response

E-mail(s) aceito(s). Enfileirado(s) para envio imediato ou agendado.

success
boolean
required
Example:

true

data
object
required