Developer Documentation

Build with the InboxOne API

Powerful APIs and MCP server to automate your cold email infrastructure. Provision mailboxes, manage domains, and export to 5 platforms programmatically.

Quick StartQuick Start
Get API Key
RESTful API icon

RESTful API

Full-featured REST API with comprehensive documentation. Manage domains, mailboxes, and exports programmatically.

Payment Webhooks icon

Payment Webhooks

Receive PayPal webhook notifications for payment events and subscription changes.

MCP Server (Coming Soon) icon

MCP Server (Coming Soon)

Model Context Protocol server for AI agent integrations. Let your AI assistants manage email infrastructure.

Quick Start

Get Started in 3 Steps

1

Get Your API Key

Sign up for a Scale or Max plan. Navigate to Settings → Integrations to generate your API key.

ibo_live_abc123...
2

Install the SDK

Install our official SDK using your preferred package manager.

npm install @inboxone/sdk
3

Make Your First Call

Initialize the client and start managing your email infrastructure.

client.domains.list()
Authentication

Authentication

All API requests require authentication using a Bearer token in the Authorization header.

Bearer Token Authentication

Include your API key in the Authorization header for all requests:

Authorization: Bearer ibo_live_your_api_key_here

API Keys

API keys start with ibo_live_ for production or ibo_test_ for sandbox.

MCP Server Keys

MCP keys start with mcp_ and are used for AI tool integrations.

Code Examples

Simple, intuitive APIs designed for developer productivity.

curl -X POST https://api.inboxone.io/inboxone/google-workspaces/mailboxes \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "techsales.io",
    "email": "alex@techsales.io",
    "firstName": "Alex",
    "lastName": "Johnson"
  }'
API Reference

API Endpoints

Complete reference for all available API endpoints.

Authentication

User registration, login, and token management

POST/inboxone/auth/registerRegister a new user account
POST/inboxone/auth/loginEmail/password login
POST/inboxone/auth/google-loginGoogle OAuth login
POST/inboxone/auth/refresh-tokenRefresh access token
GET/inboxone/auth/meGet current user profile
MCP Server

AI Tool Integration

Connect InboxOne to Claude, Cursor, Windsurf, and other AI tools using the Model Context Protocol.

Setup Instructions

1

Get your MCP key

Go to Settings → Integrations in your dashboard

2

Add configuration

Add the config to your AI tool's settings file

3

Start using

Manage domains and mailboxes with natural language

Configuration

Add this to your MCP configuration file:

{
  "mcpServers": {
    "inboxone": {
      "command": "npx",
      "args": ["-y", "@inboxone/mcp-server"],
      "env": {
        "INBOXONE_MCP_KEY": "mcp_your_key"
      }
    }
  }
}

Available Operations

Domain Management

  • Search & register domains
  • Configure DNS records
  • Verify nameservers

Mailbox Operations

  • Create mailboxes
  • Reset passwords
  • Export credentials

Deliverability

  • Run placement tests
  • Check SPF/DKIM/DMARC
  • Monitor blacklists

Billing & Quota

  • Check wallet balance
  • View usage stats
  • Manage subscription

Rate Limits & Error Codes

Rate Limits

Password Reset3 attempts per email per 5 minutes
Mailbox Creation10 mailboxes/hour per workspace
Manual Health Check1 per 5 minutes per domain
Deliverability TestsBased on subscription plan

HTTP Status Codes

200OK - Request succeeded
201Created - Resource created successfully
400Bad Request - Validation error
401Unauthorized - Missing or invalid token
402Payment Required - Insufficient wallet funds
403Forbidden - Quota exceeded or access denied
404Not Found - Resource doesn't exist
429Too Many Requests - Rate limited
500Internal Server Error
Start Building

Ready to Automate?

API and MCP access included in Scale and Max plans. Get your keys and start building in minutes.

View PricingView Pricing
Talk to SalesTalk to Sales
Inbox One Logo

Cold email infrastructure platform. Buy domains, provision Google Workspace mailboxes, auto-configure DNS, and export to 5 outreach platforms — all from one dashboard.

© 2026 InboxOne. All rights reserved.