How do I authenticate MailRush API requests?

Updated Nov 2, 2026

Every API request carries your API key in the x-api-key header.

Steps

  1. Copy your key from Settings, API Key.
  2. Send requests to https://app2.mailrush.io with the header x-api-key: YOUR_API_KEY.
  3. Open the API tab of Support for the endpoints, fields and examples.

Available endpoints

  • POST /api/v2/email sends one email from one of your sender accounts.
  • POST /api/v2/email/validate queues validation of one address.
  • POST /api/v2/contacts creates a contact; POST /api/v2/contacts/unsubscribe unsubscribes one.
  • There are no API endpoints for managing campaigns or reading reports.

Troubleshooting

401 Unauthorized
The key is wrong or missing, or your organization is not active.

More details in the FAQ

The FAQ is in the MailRush.io app under Support (sign-in required).

Related articles

Didn't find what you need?

Sign in to MailRush.io and open a support ticket, and our support team will get back to you.

Contact support