3 APIs
Email, CRM e SMS — uma única conta
500 / min
Pedidos por conta
Alojado na Suíça
Desde 2001, dados na Suíça
OAuth 2.0
Bearer, chave API ou OAuth 2.0 (PKCE)

Três APIs. Uma plataforma.

Escolha a que precisa — ou combine as três. REST e JSON, documentadas endpoint a endpoint no portal de programadores.

v2

Email API

Faça a gestão dos seus livros de endereços e modelos, envie campanhas e emails transacionais, acompanhe as suas estatísticas. JSON ou XML.

  • →Campanhas e emails transacionais
  • →Estado de entrega de cada envio unitário
  • →Livros de endereços, modelos, remetentes
  • →Estatísticas: aberturas, cliques, países, devoluções
Ver a doc da Email API →
v3

CRM API

Faça a gestão dos seus contactos, campos personalizados, etiquetas e segmentos — e envie email e SMS a esses contactos. Webhooks e OAuth 2.0 para ferramentas de terceiros.

  • →Contactos, listas, etiquetas e segmentos
  • →Envio de emails e SMS aos contactos
  • →Webhooks: eventos em tempo real
  • →OAuth 2.0 (PKCE) para Zapier, Make, n8n
Ver a doc da CRM API →
v2

SMS API

Envie SMS em massa ou à unidade, a nível internacional, diretamente a partir da sua aplicação. Listas de números e histórico incluídos.

  • →SMS em massa e individuais
  • →Cobertura internacional (prefixo 00)
  • →Confirmações de entrega por webhook (sms.delivered)
  • →Agendamento e cancelamento
Ver a doc da SMS API →
Para programadores

Ferramentas modernas, sem surpresas.

Tudo o que precisa para entregar as suas integrações rapidamente e operá-las com confiança.

REST + JSON

Recursos previsíveis, formatos de erro coerentes com identificador de pedido, verbos e códigos HTTP padrão. XML disponível nas APIs Email e SMS.

Três modos de autenticação

Token Bearer (30 dias, renovável), chave API, ou OAuth 2.0 com PKCE e permissões por âmbito para aplicações de terceiros. HTTPS em todo o lado.

Documentação OpenAPI em 6 línguas

Cada endpoint descrito com os seus parâmetros, respostas e exemplos; teste as chamadas a partir da documentação. Especificação OpenAPI transferível para gerar o seu cliente.

Webhooks assinados

Email entregue, devolução, abertura, clique, contacto criado, SMS entregue… enviados para o seu URL em JSON, assinados com HMAC-SHA256, com novas tentativas automáticas.

Acompanhamento da entrega

Cada email transacional devolve um identificador; consulte o seu estado (entregue, adiado, devolvido) ou receba o evento email.delivered.

Limites de taxa previsíveis

500 pedidos/min por conta. Acima disso, resposta 429 com cabeçalhos X-RateLimit-* e Retry-After — sem limitação silenciosa.

Casos de utilização

Dos emails de inscrição aos SMS internacionais — uma única integração.

Quer desenvolva um SaaS, uma plataforma de comércio eletrónico ou uma ferramenta interna, as nossas APIs cobrem todas as necessidades de mensagens do seu produto.

Emails transacionais e de marketing

Emails de boas-vindas, reposições de palavra-passe, recibos, newsletters e campanhas completas — e, para cada envio unitário, a confirmação da entrega ao servidor do destinatário.

Sincronização CRM e contactos

Mantenha perfis, etiquetas e segmentos sincronizados com a sua base de produto; ligue o Zapier, o Make ou o n8n em OAuth 2.0, ou deixe um webhook avisar a sua ferramenta a cada alteração.

Notificações SMS em todo o mundo

Códigos de dois fatores, alertas de entrega, lembretes de marcações — enviados para todo o mundo, com confirmação de entrega por webhook.

POST https://o-seu-servidor/webhook · email.delivered
200 OK
X-Mailpro-Signature: t=1758000000,v1=5a72…c8b1
X-Mailpro-Event-Type: email.delivered

{
  "id": "evt_5f2c…",
  "type": "email.delivered",
  "created": 1758000000,
  "apiVersion": "v3",
  "account": { "id": 12345, "name": "A minha empresa" },
  "data": {
    "email": "[email protected]",
    "idSending": 987654,
    "sendingType": 3,
    "diagCode": "250 2.0.0 OK",
    "deliveredAt": "2026-09-16T08:03:41Z"
  }
}

Recursos para programadores

A referência técnica no portal, as respostas práticas na FAQ, exemplos no GitHub.

{ }

Portal de programadores

A documentação completa das APIs Email, CRM e SMS: endpoints, parâmetros, respostas, códigos de erro, webhooks e autenticação. Em português e em cinco outras línguas.

?

FAQ API e Webhooks

Os três tipos de webhooks, o acompanhamento da entrega, a verificação da assinatura, os limites, Zapier / Make / n8n, SMTP ou API… explicados passo a passo.

Exemplos no GitHub

Um «starter» open source (licença MIT) com exemplos de chamada em Node.js, Python, PHP, C# e Java, a adaptar ao seu projeto.

API — perguntas frequentes

Respostas rápidas para os programadores que integram a Mailpro. O detalhe está na FAQ API e Webhooks.

Como obter uma chave API?+

Inicie sessão na sua conta Mailpro e abra Configurações → Configurações de API. Aí encontrará o seu identificador de cliente e a sua chave API. Pode chamar as API diretamente com eles, trocá-los por um token Bearer através de POST /v3/token, ou criar uma aplicação OAuth 2.0 em Configurações → Aplicações OAuth.

Que métodos de autenticação são suportados?+

Três: o token Bearer (válido 30 dias, renovável), oidentificador de cliente + chave API, e OAuth 2.0 com PKCE (recomendado para aplicações de terceiros e plataformas como Zapier, Make e n8n, com permissões por âmbito). Um mesmo token funciona nas API Email, CRM e SMS.

As API são REST ou SOAP?+

São API REST sobre HTTPS. As respostas são em JSON (as API Email e SMS também suportam XML, através da extensão .json / .xml do URL), com recursos previsíveis, verbos HTTP padrão e códigos de estado.

Existe documentação interativa ou um modo de teste?+

Sim. O portal de programadores descreve cada endpoint (OpenAPI) e permite experimentar as chamadas a partir da documentação. Pode enviar emails e SMS de teste para o seu próprio endereço antes de passar à produção.

Que linguagens posso utilizar? Existe um SDK?+

Qualquer linguagem capaz de falar HTTP e JSON. Publicamos no GitHub um starter open source com exemplos em Node.js, Python, PHP, C# e Java, e a especificação OpenAPI do portal permite gerar um cliente na linguagem da sua escolha.

As API suportam webhooks?+

Sim, nos três sentidos: a Mailpro avisa-o dos eventos (email entregue, aberto, clicado, devolvido, contacto criado, SMS entregue…) por chamadas HTTP assinadas com HMAC-SHA256 e com novas tentativas; as suas automações podem chamar uma ferramenta externa (ação «Enviar um webhook»); e uma ferramenta externa pode acionar uma automação (webhook de entrada). Os três tipos de webhooks explicados.

Posso enviar emails transacionais e acompanhar a sua entrega?+

Sim. Envie um email único a um destinatário com campos personalizados, anexos e agendamento opcional, através da Email API ou da CRM API. O envio devolve um identificador; GET /v3/Send/{id}/Status indica-lhe depois se está em fila, enviado, entregue, adiado ou devolvido (estado disponível cerca de 5 minutos após a entrega, conservado 365 dias). Em detalhe.

Posso enviar ficheiros anexados? Quais são os limites e o custo?+

Sim — anexe ficheiros ao enviar um email através daEmail API (v2) ou da CRM API (v3): até 5 ficheiros, 10 MB por ficheiro e 15 MB no total. Envie-os como anexos codificados em Base64 em qualquer das API (a Email API também aceita carregamentos de ficheiros multipart/form-data). O custo é de 1 crédito por cada 500 KB de anexos, com os primeiros 500 KB incluídos no crédito base do email (por isso os anexos até ~500 KB não acrescentam nada). São aceites os formatos comuns de documentos e imagens; os ficheiros executáveis e de script (.exe, .bat, .js, .vbs, .msi, .jar, .dll, etc.) são bloqueados por segurança.

Como funciona o preço dos SMS?+

Os SMS baseiam-se em créditos. Um SMS custa o preço em créditos do país de destino multiplicado pelo número de partes (uma mensagem longa é dividida em várias partes). O envio de emails utiliza créditos de email.

Que formatos de endereço de email são aceites?+

Qualquer endereço em conformidade com a RFC, incluindo o sub-endereçamento com um «+» (por exemplo [email protected]), suportado pelo Gmail, Fastmail, Proton e outros.

Quais são os limites de taxa?+

500 pedidos por minuto e por conta. Acima disso, recebe uma resposta HTTP 429 com os cabeçalhos X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset e Retry-After, para poder abrandar e repetir de forma controlada. As chamadas à API dispõem ainda de uma quota de créditos API ligada aos seus créditos de email.

Envie o seu primeiro pedido em poucos minutos.

Crie uma conta Mailpro gratuita, obtenha a sua chave API em Configurações → Configurações de API e comece a enviar — sem cartão de crédito.