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