Toda a documentação técnica está reunida no portal de programadores Mailpro, disponível em português, inglês, francês, alemão, espanhol e italiano. Cada API é descrita endpoint por endpoint, com os parâmetros, as respostas, os códigos de erro e exemplos prontos a copiar.
Três API, uma mesma conta
- Email API v2 — listas de contactos, modelos, remetentes, campanhas e emails transacionais (JSON ou XML).
- CRM API v3 — contactos e campos personalizados, listas, etiquetas, segmentos, envio de emails e SMS, webhooks, OAuth 2.0 para ferramentas de terceiros.
- SMS API — SMS unitários e em massa, listas de números, histórico.
O que mais encontrará
- A descrição OpenAPI de cada API, para gerar um cliente na sua linguagem.
- O acompanhamento da entrega dos emails transacionais — ver a FAQ.
- A referência dos webhooks: eventos, formato das mensagens, assinatura — os três tipos de webhooks.
Para começar
- Obtenha a sua chave API nas configurações da sua conta Mailpro (ou crie uma aplicação OAuth).
- Obtenha um token:
POST https://api.mailpro.com/v3/token. - Faça uma primeira chamada, por exemplo a lista dos seus remetentes, depois um envio transacional.
Já utiliza a API Email v2 com IdClient + ApiKey? Nada muda: esse modo continua suportado. O token Bearer e a API v3 acrescentam-se, não substituem nada.
Hesita entre SMTP e API? Compare as duas abordagens.