SadaSend

npx add-mcp 'https://mcp.sadasend.com'

Comece aqui

Quatro conceitos fundamentais valem a leitura antes de qualquer outra coisa.

• Quickstart — instale, defina uma chave, envie. Menos de dez linhas.
• Guardrails — escopos, listas de permissão de destinatários, restrições de IP CIDR, datas de expiração e modo de aprovação.
• Proveniência de Agente e Canal — rastreamento nativo para Claude, Cursor e bots de backend personalizados sem nenhuma alteração de código.
• Configuração de domínio — os quatro registros DNS (SPF, DKIM, DMARC, MX) e para que serve cada um.
• Marcação de Campanha UTM — injeção nativa de parâmetros UTM em links de e-mail com preservação de âncora e consulta.

Quatro formas de conectar

O SadaSend fornece quatro protocolos de entrada de primeira classe, dependendo de onde seus e-mails se originam:

• SDKs oficiais de cliente [LIVE]: Bibliotecas de cliente sem dependências (sadasend no npm e PyPI) estão ativas com resultados de união discriminada, auto-idempotência e guardrails aplicados pelo servidor. Instale via npm install sadasend ou pip install sadasend. Veja o guia do SDK.

• Model Context Protocol (MCP) [LIVE E EM DESTAQUE]: Ferramentas nativas para assistentes de codificação de IA e agentes autônomos (Google Antigravity, Cursor, Cline, Claude Desktop, Windsurf, Claude Code CLI, OpenCode e ChatGPT/Codex). Hospedado em https://mcp.sadasend.com com HTTP/SSE transmissível e 12 ferramentas completas de e-mail. Saiba mais no guia do MCP.

• API RESTful: JSON limpo e previsível sobre HTTPS para aplicações web, microsserviços e backends sem servidor (https://api.sadasend.com/emails). Explore a referência da API.

• Relay SMTP: Relay de substituição sem código para WordPress, WooCommerce, Supabase Auth, Laravel e mailers padrão (smtp.sadasend.com:587). Leia o guia do relay SMTP.

URL base e autenticação

Toda requisição é autenticada com um token de portador. As chaves são limitadas por ambiente e possuem seus próprios limites, listas de permissão de IP, datas de expiração e tags de persona.

POST https://api.sadasend.com/v1/emails
Authorization: Bearer sada_live_sk_…
Idempotency-Key: 6f1c2a80-…
X-SadaSend-Agent: SupportBot
X-SadaSend-Source: agent
Content-Type: application/json

{
  "from": "notifications@yourdomain.com",
  "to": "user@example.com",
  "cc": ["team@example.com"],
  "bcc": ["archive@yourdomain.com"],
  "subject": "Your receipt",
  "html": "<p>Thank you for your order.</p>",
  "agent_name": "SupportBot",
  "source": "agent"
}

Modos e prefixos de chave de API

O prefixo da chave informa seu modo antes de a requisição chegar à rede:

• Live (sada\_live\_sk\_…\): Envio normal de produção. Despacha e-mails diretamente para as caixas de entrada dos destinatários.

• Aprovação (sada\_agent\_sk\_…\): Modo humano-no-circuito para agentes de IA autônomos. Cada envio é retido em pending_approval até ser revisado e aprovado no seu painel.

• Teste (sada\_test\_sk\_…\): Modo de integração e CI. Valida esquemas e modelos sem enviar e-mails reais.

Proveniência de Canal e Agente

Todo e-mail aceito pelo SadaSend é automaticamente marcado com seu canal de entrada (mcp, sdk, api, smtp), fonte da persona de envio (agent, backend, automation, system) e identificador de agente opcional.

A proveniência dá à sua equipe observabilidade completa de entregabilidade. Você pode filtrar o log de Atividade de E-mail por nome de agente, inspecionar cartões de origem no painel de detalhes do e-mail e revisar a saúde de entregabilidade do agente e as taxas de rejeição nas análises do seu painel.

// Ingress channels supported
"channel": "mcp" | "sdk" | "api" | "smtp"

// Sending persona sources
"source": "agent" | "backend" | "automation" | "system"

// Agent identifier (up to 128 characters)
"agent_name": "Claude 3.7 Assistant"

Limites de taxa e cabeçalhos de cota

Toda resposta da API emite cabeçalhos padrão de limite de taxa e cota, permitindo que clientes e SDKs acompanhem as permissões em tempo real:

Cabeçalho	Descrição
X-RateLimit-Limit	Volume máximo de destinatários permitido na janela de limite de taxa ativa da chave.
X-RateLimit-Remaining	Capacidade restante de destinatários na janela de limite de taxa ativa.
X-RateLimit-Reset	Segundos até o bucket de limite de taxa atual ser redefinido.
Retry-After	Segundos para aguardar antes de tentar novamente quando limitado com HTTP 429.
X-Quota-Limit	Cota total mensal de e-mails incluída no seu plano de conta atual.
X-Quota-Used	Número de e-mails enviados durante o período de faturamento mensal atual.
X-Quota-Reset	Carimbo de data/hora ISO 8601 quando a cota mensal de e-mails do seu plano de conta é redefinida.
X-Quota-Overage	Número de e-mails enviados que excedem a cota do plano (cobrados pela taxa de excedente padrão).

O domínio sandbox de integração

Toda nova conta pode enviar imediatamente de onboarding.sadasend.com sem configurar registros DNS primeiro.

Para proteger a reputação compartilhada entre todos os clientes, o sandbox tem um limite vitalício de 100 mensagens por conta. Adicionar e verificar seu próprio domínio de envio personalizado remove esse limite completamente.

Erros

Erros retornam um código legível por máquina e uma mensagem legível por humanos. Ambos estão sempre presentes.

{
  "error": "recipient_not_allowlisted",
  "message": "Key allowlist is [@example.com]. Recipient is outside it.",
  "docs": "https://www.sadasend.com/docs/errors#recipient_not_allowlisted"
}