# Mailpro APIs

> REST APIs of Mailpro, a Swiss email marketing and SMS platform (Mailpro by Maxony, Geneva): send emails and SMS, manage contacts, lists and senders, follow deliveries, receive webhooks. Answers are JSON (XML also on the Email API v2 and the SMS API).

Use the static references below: they contain every route, parameter and example as plain HTML, without JavaScript. The pages crm-api.html, email-api.html and sms-api.html show the same content as an interactive viewer that needs JavaScript.

## API references

- [CRM API v3 reference](https://api.mailpro.com/developers/specs/en/crm-v3.html): contacts, lists, tags, custom fields, segments, campaigns, single emails, sender addresses, bounces and unsubscribers, SMS. Base URL: https://api.mailpro.com/v3
- [Email API v2 reference](https://api.mailpro.com/developers/specs/en/email-v2.html): address books, messages, campaigns, single emails, sender addresses, statistics, bounces and unsubscribers. Base URL: https://api.mailpro.com/v2
- [SMS API reference](https://api.mailpro.com/developers/specs/en/sms-v2.html): phone lists, bulk and single SMS, scheduling, credits, history, short links. Base URL: https://api.mailpro.com/sms

## OpenAPI specifications

- [CRM API v3 (OpenAPI JSON)](https://api.mailpro.com/developers/specs/en/crm-v3.json)
- [Email API v2 (OpenAPI JSON)](https://api.mailpro.com/developers/specs/en/email-v2.json)
- [SMS API (OpenAPI JSON)](https://api.mailpro.com/developers/specs/en/sms-v2.json)

Each reference and specification also exists in French, German, Italian, Portuguese and Spanish: replace `/en/` with `/fr/`, `/de/`, `/it/`, `/pt/` or `/es/` in the address.

## What the APIs can do

- Send single (transactional) emails and bulk campaigns, now or at a future date; list, cancel and reschedule what is scheduled.
- Follow the delivery of a single email: `GET /v3/Send/{id}/Status`, or the `email.delivered` and `email.bounced` webhooks.
- Manage contacts, lists, tags and custom fields; import files; count and list the contacts of a segment; read the 90-day activity of a contact.
- Read, add and remove bounces and unsubscribers.
- Add a sender address and send its validation email; check its domain live (SPF, DKIM, DMARC, MX) and get the DNS records to publish. DKIM itself is activated in the Mailpro application.
- Send SMS, with optional short links (`shorten_urls=true`, SMS API only).
- Receive webhooks signed with HMAC-SHA256.

Creating or deleting a segment, and activating DKIM, are done in the Mailpro application, not by API.

## Authentication

- OAuth 2.0 (`POST https://api.mailpro.com/oauth/token`), with per-application keys and scopes.
- Bearer JWT (`POST https://api.mailpro.com/v3/token`).
- Client ID and API key, found on the API page of the Mailpro account.

## Guides

- [Multiple API keys](https://api.mailpro.com/developers/api-keys.html)
- [Webhooks](https://api.mailpro.com/developers/webhooks.html)
- [Developer portal](https://api.mailpro.com/developers/)
- [API FAQ](https://www.mailpro.com/faq/category/smtp-api)