A API REST do Mailpro permite integrar todas as funcionalidades de email marketing diretamente na sua aplicação — envio de emails transacionais, gestão de contactos, criação de campanhas e acesso a estatísticas — através de pedidos HTTP padrão com autenticação por API key.

Autenticação

Todos os pedidos à API Mailpro requerem autenticação via Bearer Token no cabeçalho HTTP: Authorization: Bearer SUA_API_KEY. A API key é gerada nas definições da conta Mailpro e deve ser guardada em segurança — nunca exposta em código JavaScript do lado do cliente ou em repositórios públicos.

Envio de email transacional via API

O endpoint de envio aceita um payload JSON com remetente, destinatário(s), assunto, corpo em HTML e/ou texto simples, e opcionalmente variáveis de personalização e anexos. A resposta inclui um ID único de mensagem que permite rastrear o estado de entrega via API ou webhooks.

Para empresas portuguesas que integram o Mailpro em sistemas de e-commerce, ERPs ou portais de cliente, o envio transacional via API é a solução ideal para confirmações de encomenda, faturas, resets de password e notificações de sistema.

Gestão de contactos via API

A API permite criar, atualizar, eliminar e pesquisar contactos, bem como gerir listas e tags programaticamente. Isto é especialmente útil para sincronização bidirecional com CRM: quando um cliente atualiza os seus dados no portal, a alteração propaga-se automaticamente para a lista de email no Mailpro.

Boas práticas para integração em Portugal

Gestão de rate limits: A API Mailpro permite até 1.000 pedidos por minuto. Para envios em volume, use o endpoint de envio em batch que aceita até 1.000 destinatários por pedido.

Tratamento de erros: Implemente retry logic com backoff exponencial para erros 429 (rate limit) e 5xx (erros de servidor). Para erros 4xx (pedidos inválidos), registe o detalhe do erro — o corpo da resposta inclui uma mensagem descritiva.

RGPD e API: Ao criar contactos via API, certifique-se de que inclui o campo de consentimento e a data/hora em que foi obtido. A API Mailpro aceita estes campos e armazena-os para efeitos de auditoria RGPD.

SDKs e bibliotecas disponíveis

O Mailpro disponibiliza clientes oficiais para PHP, Python, Node.js e Ruby, disponíveis na documentação em api.mailpro.com/developers. Para outras linguagens, a API segue o padrão REST com JSON e pode ser integrada com qualquer cliente HTTP.

Ver também: Webhooks de Email, Servidor SMTP, Configurar Automações

Documentação e recursos para programadores

Toda a documentação técnica das APIs Mailpro está reunida no portal de programadores: Email API v2, CRM API v3 e SMS API, descritas endpoint a endpoint (OpenAPI), em português e em cinco outras línguas.

  • Acompanhamento da entrega dos emails transacionais — cada envio unitário devolve um identificador; GET /Send/{id}/Status indica se está em fila, enviado, entregue, adiado ou devolvido. Em detalhe.
  • Webhooks — três sentidos: a Mailpro avisa-o (email entregue, devolução, novo contacto…), as suas automações chamam as suas ferramentas, uma ferramenta externa aciona uma automação. Os três tipos de webhooks · referência.
  • Perguntas frequentes — autenticação, limites, anexos, Zapier / Make / n8n: FAQ API e Webhooks.

Visão geral das três APIs e exemplos de código: a página API da Mailpro.

EXPERIMENTE O MAILPRO