Novo guia: como aquecer um IP dedicado sem prejudicar sua reputação. Ler agora →
MigoSMTP
API de e-mail

Envie, acompanhe e gerencie e-mails a partir do seu código

Uma API REST para envio, templates, eventos e relatórios, com chaves de escopo restrito e erros claros.

Pronta para agentes: um servidor MCP permite que assistentes de IA enviem e inspecionem e-mails com segurança.

Requisição
POST /v1/send
{ "from": "hello@example.com",
"to": "you@example.com",
"subject": "Hello" }
Resposta
202 Accepted
{ "id": "msg_[id]" }
Idempotency-Key suportado
202 Accepted
JSON
Idempotente
Envie com uma única chamada JSONAutentique-se com uma chave bearer, envie um pequeno corpo JSON e receba um ID de mensagem na hora.
Início rápido
cURL
Node
Python
PHP
Python
import migosmtp
c = migosmtp.Client("KEY")
c.send(to="you@example.com",
template="welcome")
Enviado · 202
SDKs tipados
Código aberto
Bibliotecas oficiais para a sua stackEscolha Node, Python, PHP ou Go. As mesmas poucas linhas enviam uma mensagem e tratam erros do mesmo jeito em qualquer lugar.
Escopos de chave de API
Enviar e-mailPermitido
Ler eventosPermitido
Gerenciar domíniosSomente administradores
Limite de taxa[n] req/s
Privilégio mínimo
Rotação segura
Chaves com exatamente o acesso de que precisamCrie uma chave por serviço, limite o que cada uma pode fazer e revogue uma sem mexer nas outras.
Limite de taxa
Pico de tráfego
A fila suaviza o pico
Nada é descartado
Contrapressão
Sem perda de dados
Absorva picos com tranquilidadeQuando o tráfego ultrapassa a sua taxa, as requisições entram na fila e são processadas em vez de falhar, então nada é descartado.
eventos de mensagem
Eventos assinados
/events
200 OK
Data warehouse
200 OK
Alertas
Nova tentativa em 30s
Assinado com HMAC
Pelo menos uma vez
Os eventos voltam do mesmo jeitoA mesma superfície de API envia de volta ao seu endpoint, com assinatura, os eventos de entrega, abertura, clique e rejeição.
Envie a fatura por e-mail para a Priya e confirme a entrega
Agente de IA
MigoSMTP MCPchave com escopo
send_emailEnviar uma mensagem
get_eventsLer os resultados de entrega
check_domainVerificar registros DNS
Enviado · ID da requisição registrado · entrega confirmada
MCP pronto
Com escopo e registro
Deixe agentes de IA chamarem sua APIA mesma API está disponível via MCP, para que um agente possa enviar e-mails, ler eventos e verificar DNS. As chaves têm escopo restrito, as chamadas são registradas e os envios podem exigir aprovação.
Uma requisição
SDKs
Chaves com escopo
Limites de taxa
Webhooks
API para agentes
Relay SMTPAPI RESTWebhooksIPs dedicadosAssinatura DKIMInbound parseTemplatesAnálisesListas de supressãoMonitoramento de reputaçãoValidação de e-mailFunções de equipe e log de auditoriaRelay SMTPAPI RESTWebhooksIPs dedicadosAssinatura DKIMInbound parseTemplatesAnálisesListas de supressãoMonitoramento de reputaçãoValidação de e-mailFunções de equipe e log de auditoria
Recursos

Uma API que se comporta bem em produção

Endpoints REST

Recursos previsíveis para mensagens, templates, domínios e eventos.

Templates e variáveis

Envie pelo nome do template e passe variáveis por mensagem.

Chaves de idempotência

Tente de novo com segurança, sem enviar duplicatas.

Chaves de API com escopo

Dê a cada serviço apenas as permissões de que ele precisa.

Webhooks

Receba eventos assinados para cada resultado de entrega.

Erros e limites claros

Códigos de erro consistentes e cabeçalhos de limite de taxa.

Como funciona

Seu serviçoChama o endpoint de envio por HTTPS com uma chave de API com escopo.
API de e-mail do MigoSMTPValida a requisição, aplica templates e limites, coloca a mensagem na fila e retorna um ID.
Eventos de volta para vocêWebhooks assinados informam ao seu app os resultados de entrega, bounce e reclamação.
ETAPA 1

Crie uma chave de API

Escolha os escopos e uma lista de IPs permitidos para o serviço que vai usá-la.

ETAPA 2

Envie sua primeira mensagem

Chame o endpoint de envio com um remetente verificado e um destinatário.

ETAPA 3

Escute os eventos

Registre um webhook para acompanhar entregas, bounces e engajamento.

Veja em ação

Uma só plataforma, do primeiro envio à caixa de entrada

Alterne entre as etapas para ver o que você controla em cada uma. Interface ilustrativa. Todos os números e endereços exibidos são dados de exemplo.

app.migosmtp.com / sendDados de exemplo
Na fila
184,320
Enviados hoje
6,418,905
Taxa
412/s
aceitomensagem para you@example.com
aceitomensagem para team@example.com
na filalote de 25.000 destinatários
aceitomensagem para ops@example.com
Para desenvolvedores

Versionada, documentada e fácil de testar

Tudo o que está no painel também está disponível pela API, com exemplos nas linguagens que você usa.

  • Chaves com escopo e lista de IPs permitidos
  • Requisições idempotentes para novas tentativas seguras
  • Formato de erro consistente
  • SDKs e exemplos prontos para copiar
Visão rápida
URL baseapi.migosmtp.com/v1
AutenticaçãoChave de API Bearer
FormatoJSON sobre HTTPS
EventosWebhooks assinados
ReferênciaReferência completa da API e exemplos de SDK
Visão geral

O que é uma API de e-mail?

Uma API de e-mail é uma interface web que permite ao seu código enviar e gerenciar e-mails chamando endpoints HTTP, em vez de falar SMTP. Com a API de e-mail do MigoSMTP, você faz um POST de uma requisição JSON com um remetente verificado, um destinatário e o conteúdo ou o nome de um template, e a mensagem entra na fila para entrega pela nossa infraestrutura MigoMTA. A resposta traz um identificador para acompanhá-la. Você também pode enviar com HTTP puro.

A API serve a equipes de produto que querem recursos previsíveis para mensagens, templates, domínios e eventos. As chaves têm escopo, então um serviço de cobrança pode enviar recibos sem poder editar domínios. As chaves de idempotência tornam as novas tentativas seguras, e códigos de erro consistentes com cabeçalhos de limite de taxa permitem que os clientes reduzam o ritmo com elegância. Tudo o que está no painel também está disponível pela API. O tráfego de sandbox e de produção pode ser separado com workspaces e chaves diferentes, o que mantém os envios de teste fora dos seus relatórios e da sua reputação reais.

Para a entregabilidade, uma API oferece um controle que o SMTP não dá: erros estruturados, metadados por mensagem e webhooks de eventos que você pode devolver à sua aplicação. Combine com o tratamento de supressão e você deixa de enviar para endereços ruins automaticamente. Nosso servidor MCP permite que agentes de IA chamem a mesma API com chaves de escopo restrito e revogáveis, para que a automação fique dentro dos limites que você define. Como cada chave tem escopo e é registrada, você vê exatamente qual serviço ou agente enviou cada mensagem e pode revogar o acesso na hora, se necessário.

Casos de uso

Casos de uso comuns da API de e-mail

E-mail transacional a partir do seu app

Dispare recibos, redefinições de senha e alertas com uma única chamada de API. Envie pelo nome do template e passe variáveis, para que o código do produto fique livre de HTML e ajustes de texto.

Novas tentativas seguras em filas de jobs

Anexe uma chave de idempotência a cada envio. Se um worker falhar e tentar de novo, a API de e-mail reconhece a duplicata e não envia a mesma mensagem duas vezes.

Chaves por serviço em microsserviços

Emita uma chave de escopo restrito por serviço, com lista de IPs permitidos. Se um serviço for comprometido, você revoga uma única chave e o resto do seu pipeline de e-mail continua funcionando.

Fechando o ciclo com eventos

Combine o endpoint de envio com webhooks para que seu banco de dados reflita os estados entregue, bounce e reclamação. A equipe de suporte passa a responder para onde um e-mail foi sem abrir os logs.

Notificações em um produto SaaS

Envie eventos do app, como convites, alertas de uso e avisos de cobrança, por uma única API, com uma chave por serviço e templates sob responsabilidade da equipe de produto.

Agentes e automação

Dê a um agente de IA ou a uma ferramenta interna uma chave de escopo restrito que só envia ou só lê o status. Cada chamada é registrada nessa chave, então você pode revisar o que ela fez e revogá-la a qualquer momento.

Como escolher

API de e-mail ou relay SMTP?

Os dois entregam pela mesma infraestrutura. Escolha conforme o modo como seu software é construído.

API de e-mailRelay SMTP
Ideal paraCódigo novo que quer templates, idempotência e respostas estruturadasApps existentes, plugins de CMS e dispositivos que já falam SMTP
IntegraçãoHTTPS e JSON em qualquer linguagemHost e credenciais nas configurações de e-mail
ErrosCódigos de erro estruturados e cabeçalhos de limite de taxaCódigos de resposta SMTP
Controle de acessoChaves de API com escopo, lista de IPs permitidos opcionalCredenciais por conta e lista de IPs permitidos

Você pode usar os dois no mesmo workspace: SMTP para as ferramentas que não dá para alterar e a API para os novos serviços.

Recursos de IA

API de e-mail com apoio de IA

Pronto para agentes

Servidor MCP para agentes de IA

Conecte um assistente de IA ao MigoSMTP por um servidor MCP para que ele consulte o status das mensagens ou redija envios. As chaves carregam os escopos que você concede, e os envios podem exigir aprovação humana.

Copilot

Copilot de triagem de erros

Cole um erro de API ou uma requisição com falha e o copilot explica a causa, como um remetente não verificado ou um campo malformado, e mostra uma chamada corrigida. Você mesmo aplica a correção.

Assistência

Código de integração redigido por IA

Descreva o que você quer enviar e o assistente gera uma requisição de exemplo na sua linguagem, seguindo as convenções do nosso SDK. Revise e teste antes de ir para produção.

Preditivo

Detecção de picos e abusos

A detecção de anomalias acompanha a taxa de envio por chave e sinaliza picos incomuns. Ela pode avisar sua equipe ou sugerir pausar uma chave, e qualquer ação automática só acontece se você optar por ela.

Os recursos de IA são assistivos e opcionais: os agentes agem apenas dentro dos escopos que você concede, e sua equipe mantém o controle das chaves e dos envios.

Boas práticas

Boas práticas para a API de e-mail

Use chaves de idempotência em todos os envios

Gere uma chave estável por e-mail lógico, como o ID do pedido mais o evento. Assim, novas tentativas após timeouts nunca geram mensagens duplicadas.

Restrinja o escopo das chaves ao mínimo

Dê a cada serviço apenas as permissões de que ele precisa e adicione uma lista de IPs permitidos quando os endereços forem fixos. Um raio de impacto menor torna a resposta a incidentes mais simples.

Respeite os cabeçalhos de limite de taxa

Leia os cabeçalhos de limite em cada resposta e reduza o ritmo antes de ser limitado. O backoff exponencial com jitter lida com picos sem sobrecarregar a API.

Verifique as assinaturas dos webhooks

Confira a assinatura de cada evento antes de confiar nele. Troque o segredo periodicamente e imediatamente se houver risco de vazamento.

Guarde o ID da mensagem

Salve o identificador retornado pela chamada de envio junto ao seu próprio registro. Isso facilita as consultas do suporte e a conciliação de eventos depois.

Separe teste e produção

Use workspaces e chaves diferentes para homologação e produção. Assim, erros de teste não chegam a destinatários reais nem afetam sua reputação.

Perguntas frequentes

API de e-mail: perguntas frequentes

Precisa de ajuda com a sua integração? Nossa equipe pode revisá-la com você antes de entrar no ar.

O que é uma API de e-mail?

Uma API de e-mail é um conjunto de endpoints HTTP que permite ao seu software enviar e gerenciar e-mails sem manter servidores de e-mail. Você envia uma requisição JSON, o provedor enfileira e entrega a mensagem, e você recebe atualizações de status por respostas e webhooks.

Como envio um e-mail com a API do MigoSMTP?

Crie uma chave de API, verifique um domínio remetente e faça um POST de JSON para o endpoint de envio com o endereço de origem, o destinatário e o conteúdo ou um template com variáveis. A resposta retorna um ID de mensagem que você pode acompanhar. Veja os campos na referência da API.

Qual é a diferença entre uma API de e-mail e o SMTP?

O SMTP é um protocolo que os softwares existentes já falam, então não exige mudanças no código. Uma API usa HTTPS e JSON, o que traz erros estruturados, templates, idempotência e metadados. Os dois usam a mesma infraestrutura de entrega, então escolha conforme o modo como sua aplicação é construída.

Existe um sandbox para testar a API de e-mail?

Use um workspace e uma chave de API separados para testes, para que os envios de teste fiquem fora dos seus relatórios e da reputação do remetente em produção. Nunca compartilhe uma chave entre envios de teste e reais. Fale com a gente se precisar de um modo de teste configurado na sua conta.

Como os limites de taxa da API são aplicados?

Os limites são retornados nos cabeçalhos da resposta, para que seu cliente veja a capacidade restante e reduza o ritmo antes de ser limitado. Os valores que se aplicam a você dependem do seu plano. Crie clientes que leiam os cabeçalhos e diminuam a velocidade de forma gradual.

Posso enviar e-mails em lote?

Consulte a referência da API para ver as opções de lote e os limites de destinatários do seu plano. Seja qual for o tamanho do lote, envie uma chave de idempotência em cada requisição e respeite os cabeçalhos de limite de taxa, para que uma falha parcial possa ser repetida sem duplicatas.

O que é o servidor MCP do MigoSMTP?

Um servidor MCP é uma forma padrão de os assistentes de IA chamarem ferramentas. O nosso permite que agentes compatíveis trabalhem com a API de e-mail, por exemplo para consultar o status de mensagens, usando chaves de escopo restrito que você controla. Os envios podem exigir aprovação de uma pessoa.

Quais linguagens e SDKs são compatíveis?

É uma API REST sobre HTTPS, então qualquer linguagem capaz de fazer requisições HTTP funciona. Exemplos prontos para copiar e SDKs estão listados na documentação. Guarde as chaves de API em variáveis de ambiente ou em um gerenciador de segredos, nunca no código-fonte.

Comece a enviar em minutos.

Crie uma conta, adicione seu domínio e envie seu primeiro e-mail.