This section provides in-depth information about the MailChannels Inbound Provisioning API. If you’re new to inbound
filtering, consider starting with the Overview, or the Provisioning API
guide for a walkthrough of what you can automate.
Base URL
The base URL for API requests is https://api.mailchannels.net/inbound/v1. All requests are made to this URL, and must
use HTTPS.
Authentication
All requests to the Provisioning API must contain the X-API-Key header with your API key as the value. Requests
without a valid API key are rejected with a 401 Unauthorized response. API keys are created and managed in the Host
Console under Settings > Account > API Keys. See the Provisioning API guide for
more information about API keys and how to manage them.
Most domain operations also require a subscriptionHandle query parameter that identifies which MailChannels
subscription the domain belongs to. Retrieve your subscription handles from the /subscriptions endpoint.
Rate limits
The API allows up to 100 requests per second per customer. Requests that exceed this limit receive a
503 Service Temporarily Unavailable response. Last modified on July 30, 2026