MailReach API

The MailReach REST API. Authenticate requests with your project's API key passed in the X-Api-Key header, prefixed with Bearer — for example: X-Api-Key: Bearer YOURAPIKEY. You can find your API key in the Settings tab of your account. There are no special costs for API usage — requests are included in your regular plan.

Webhooks

MailReach can notify your systems in real time when something happens on an account, domain or spam test. Every event is delivered as a JSON payload to a webhook URL you provide, or posted directly into a Slack channel you connect.

You configure which events fire — and where they are sent — from the Alerts tab in your MailReach settings. The API itself does not expose webhook management endpoints; this section is informational so you know what your integration can react to.

Triggerable events

• An email account gets disconnected — one or more accounts lost their connection.
• A domain is expiring soon — a connected domain is approaching its expiration date.
• A new warming mode is proposed — MailReach recommends switching an account to a new warming mode.
• An account is back to a normal warming mode — the account returned to its standard mode.
• An email account has a problem of missing inbound emails — expected inbound emails are not being received.
• An email account has a reputation score decrease — the account's reputation score dropped.
• An email account has a reputation score increase — the account's reputation score improved.
• An email account has sent too many messages — sending volume exceeds safe thresholds.
• A Sendgrid account has a problem of missing emails — a SendGrid-connected account is not receiving expected emails.
• An Outlook account has a problem of missing outgoing emails — an Outlook account is failing to send expected outgoing emails.
• An automated spam test has been completed — a scheduled spam test finished.