# 📬 Welcome to the Mailpool API The Mailpool API lets you automate your entire cold-email infrastructure — register domains, provision mailboxes, run deliverability checks, and push everything straight into your sending platforms. #### With the Mailpool API, you can: > 💡 Build and scale sending infrastructure programmatically, without touching a dashboard. - Register domains, manage DNS records, configure DMARC, and transfer domains in or out - Provision and manage Google, Outlook, shared, and private mailboxes at scale - Run spam, blacklist, and inbox placement checks to protect deliverability - Export mailboxes directly to Instantly, Smartlead, and other sending platforms - Manage subscription slots as your infrastructure grows Everything you build through the dashboard at [app.mailpool.ai](https://app.mailpool.ai) is available through the API, so you can wire Mailpool into your own tooling, automations, and workflows. --- ## Getting Started > 💡 You only need three things to make your first request: a base URL, an API key, and an endpoint. **1. Base URL** All requests are made against: ``` https://app.mailpool.ai/v1/api ``` **2. Authenticate** The API uses an API key passed in the `X-Api-Authorization` header. Generate a key from your workspace settings and include it on every request: ```bash curl https://app.mailpool.ai/v1/api/mailboxes \ -H "X-Api-Authorization: YOUR_API_KEY" ``` **3. Make your first call** [List your mailboxes](https://api.mailpool.ai/docs/mailpool/4sdd7n37hkkpp-get-mailboxes-list) Browse every endpoint, view request and response schemas, and try requests directly from the docs. --- ![domains-icon](https://img.icons8.com/cotton/64/000000/domain.png) ## Core Resources > 💡 Mailpool is organized around a few core resources. Here's where to start. ![domain-icon](https://img.icons8.com/cotton/64/000000/domain.png) #### Domains Search and register domains, manage DNS and DMARC, check status, and handle transfers. [View endpoints](https://api.mailpool.ai/docs/mailpool/uxh9k2ll6t66g-get-domains-list) ![mailbox-icon](https://img.icons8.com/cotton/64/000000/secured-letter.png) #### Mailboxes Provision Google, Outlook, shared, and private mailboxes, then update or delete them as needed. [View endpoints](https://api.mailpool.ai/docs/mailpool/4sdd7n37hkkpp-get-mailboxes-list) ![deliverability-icon](https://img.icons8.com/cotton/64/000000/spam.png) #### Deliverability Run spam scores, IP blacklist checks, and inbox placement tests to keep your sending healthy. [View endpoints](https://api.mailpool.ai/docs/mailpool/bsjt03w962skw-get-spam-checks-list) --- ![explore-icon](https://img.icons8.com/cotton/64/000000/search-in-cloud.png) ## Explore the API > 💡 Pick the workflow that matches what you're building. **Stand up sending infrastructure** Register domains, configure DNS and DMARC, and provision mailboxes in bulk. - [Get domain suggestions](https://api.mailpool.ai/docs/mailpool/ngojihgwxu1zq-get-domains-suggestions) - [Register a domain](https://api.mailpool.ai/docs/mailpool/kjlghqtyl3rll-register-domains) - [Create mailboxes](https://api.mailpool.ai/docs/mailpool/ifa3dq3hujxkn-create-mailboxes) **Protect your inbox placement** Verify that your domains and IPs aren't blacklisted and that your messages land in the inbox. - [Run a spam check](https://api.mailpool.ai/docs/mailpool/gxbtahp6mtrwe-create-spam-check) - [Check an IP blacklist](https://api.mailpool.ai/docs/mailpool/ipblchk4createp-create-ip-blacklist-check) - [Start an inbox placement test](https://api.mailpool.ai/docs/mailpool/pewzijcbwevof-create-inbox-placement) **Push mailboxes to your tools** Save platform credentials once, then export mailboxes to Instantly, Smartlead, CSV, and more. - [Save platform credentials](https://api.mailpool.ai/docs/mailpool/expt1credsavedo-save-platform-credentials) - [Export mailboxes](https://api.mailpool.ai/docs/mailpool/expt3mailboxpost-export-mailboxes-to-a-platform) - [Check export status](https://api.mailpool.ai/docs/mailpool/expt5batcheslist-get-export-batches-list) --- ![faqs-icon](https://img.icons8.com/cotton/64/000000/scroll--v1.png) ## FAQs > 💡 The quick answers to the most common questions. **How do I authenticate?** Every request must include your API key in the `X-Api-Authorization` header. A small number of public endpoints (such as domain suggestions) also accept anonymous requests, but most resources require a valid key. **What's the base URL?** All endpoints live under `https://app.mailpool.ai/v1/api`. **Which mailbox types are supported?** Mailpool supports Google, Outlook, shared, and private mailboxes. Each type has its own creation and update payloads — see [Create mailboxes](https://api.mailpool.ai/docs/mailpool/ifa3dq3hujxkn-create-mailboxes) for details. **Which platforms can I export to?** You can export mailboxes to platforms like Instantly and Smartlead, or download them as CSV. Save your platform credentials first, then trigger an export batch. Secret fields such as API keys and passwords are stored encrypted and returned masked. **Do you support webhooks?** Yes. See the [Webhooks](https://api.mailpool.ai/docs/mailpool/qhughmtu2907r-webhooks) reference for the events Mailpool can send to your endpoints. --- ![support-icon](https://img.icons8.com/cotton/64/000000/technical-support.png) ## We're Here to Help > 💡 Stuck on something? Reach out — we're happy to help you get up and running. Browse the full [API Reference](https://api.mailpool.ai/docs/mailpool/uxh9k2ll6t66g-get-domains-list) for detailed schemas, examples, and try-it-out requests for every endpoint. Need a hand? Get in touch with the Mailpool team at [contact@mailpool.ai](mailto:contact@mailpool.ai). > If you're a member of this workspace, please log in [here](auth). Built with ❤️ by [Mailpool](https://app.mailpool.ai).