API de e-mail

A API de e-mail envia e-mails da sua aplicação por HTTPS em vez de uma conexão SMTP. Use-a para e-mails transacionais, como confirmações de cadastro, redefinições de senha, recibos e alertas, principalmente quando você quer templates, agendamento, novas tentativas idempotentes e um ID separado para cada destinatário.

Como funciona

1. A sua aplicação chama POST /emails com um endereço From em um domínio de envioDomínio de envioUm domínio seu, verificado com registros DNS, para que o Emailit possa enviar e-mails a partir dele com SPF, DKIM e um return path personalizado. verificado, os destinatários e o conteúdo ou um template.
2. O Emailit valida a requisição, cobra 1 crédito por destinatário e cria um e-mail por destinatário, cada um com o seu próprio ID em_.
3. A resposta volta na hora com o status accepted, ou scheduled se você definiu um horário de envio. A entrega acontece em segundo plano.
4. O Emailit assina a mensagem com DKIM para o seu domínio, faz a verificação de spam e entrega o e-mail. Falhas temporárias recebem novas tentativas por cerca de 21 horas.
5. Cada mudança de status aparece em Email API›Emails e é enviada aos seus webhooks.

URL base e autenticação

Uma chave Full Access pode chamar todos os endpoints. Uma chave Sending Only pode enviar, reagendar, cancelar, tentar de novo e encaminhar e-mails, e você pode restringi-la a um único domínio de envio. Consulte Autenticação para mais detalhes.

Enviar um e-mail

curl https://api.emailit.com/v2/emails \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Welcome to Acme",
    "html": "<p>Thanks for signing up, Ada.</p>",
    "text": "Thanks for signing up, Ada."
  }'

import { Emailit } from '@emailit/node';

const emailit = new Emailit(process.env.EMAILIT_API_KEY);

const email = await emailit.emails.send({
  from: 'Acme <hello@acme.com>',
  to: 'ada@example.com',
  subject: 'Welcome to Acme',
  html: '<p>Thanks for signing up, Ada.</p>',
  text: 'Thanks for signing up, Ada.',
});

console.log(email.id);

import os
from emailit import EmailitClient

client = EmailitClient(os.environ["EMAILIT_API_KEY"])

email = client.emails.send({
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Welcome to Acme",
    "html": "<p>Thanks for signing up, Ada.</p>",
    "text": "Thanks for signing up, Ada.",
})

$emailit = Emailit::client(getenv('EMAILIT_API_KEY'));

$email = $emailit->emails()->send([
    'from' => 'Acme <hello@acme.com>',
    'to' => 'ada@example.com',
    'subject' => 'Welcome to Acme',
    'html' => '<p>Thanks for signing up, Ada.</p>',
    'text' => 'Thanks for signing up, Ada.',
]);

Uma requisição bem-sucedida retorna 200 com o novo e-mail:

{
  "object": "email",
  "id": "em_33VtK8mRq1xZp7LwN4cY2bHsDfa",
  "token": "33VtK8m4XcPq2RwZ7nLb1YsTgHd",
  "message_id": "<33VtK8m4XcPq2RwZ7nLb1YsTgHd@acme.com>",
  "from": "Acme <hello@acme.com>",
  "to": ["ada@example.com"],
  "subject": "Welcome to Acme",
  "status": "accepted",
  "scheduled_at": null,
  "created_at": "2026-10-01T09:30:12.418203Z",
  "tracking": { "loads": false, "clicks": false }
}

Os workspaces novos começam no modo sandbox e só podem enviar para os endereços de e-mail das contas dos membros do workspace. Solicite acesso de produção antes de enviar para qualquer outra pessoa.

O que você pode fazer

Limites

Os limites de envio contam destinatários, então uma requisição para 10 destinatários usa 10 da sua cota por segundo e diária. Os workspaces Pro e Business recebem aumentos automáticos com base na saúde de envio, e qualquer workspace pode pedir mais no card Sending Limits da página inicial do painel. Consulte Limites e cotas e Limites de requisições.

Créditos

Cada destinatário custa 1 crédito, e os endereços em to, cc e bcc contam todos. Se o workspace não tiver créditos suficientes para todos os destinatários, a requisição falha com 402 e nada é enviado. Novas tentativas e encaminhamentos são cobrados como novos envios.

Consulte Como funcionam os créditos para saber como os créditos incluídos e comprados são usados.

Próximos passos