Inbound Logo Inbound Logo

​
Inbound API v2

Transform any email address into a powerful API endpoint. Inbound provides a simple yet robust way to receive, process, and manage emails programmatically.

​
Base URL

All API requests are made to: 
https://inbound.new/api/v2

​
Getting Started

1

Get Your API Key

Sign up at inbound.new and generate an API key from your dashboard.
2

Set Up Authentication

Include your API key in the Authorization header of all requests:
Authorization: Bearer your_api_key_here
3

Make Your First Request

List your emails to verify authentication:
curl -X GET https://inbound.new/api/v2/mail \
  -H "Authorization: Bearer your_api_key_here"

​
API Features

List Emails

Retrieve all emails with filtering, pagination, and search capabilities

Get Email Details

Fetch complete email content including headers, attachments, and metadata

Reply to Emails

Send replies to received emails with full threading support

Authentication

Learn how to authenticate and secure your API requests

​
Quick Example

Here’s a complete example of retrieving and processing emails: 
curl -X GET https://inbound.new/api/v2/mail \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json"

​
Response Format

All API responses follow this consistent format: 
{
  "emails": [...],
  "pagination": {
    "total": 150,
    "limit": 50,
    "offset": 0,
    "hasMore": true
  },
  "filters": {
    "uniqueDomains": ["example.com", "test.com"]
  }
}

​
Error Handling

API errors are returned with appropriate HTTP status codes and descriptive error messages: 
{
  "error": "Invalid or missing API key"
}
Common status codes:
  • 200 - Success
  • 400 - Bad Request (invalid parameters)
  • 401 - Unauthorized (invalid API key)
  • 404 - Not Found (email not found)
  • 500 - Internal Server Error

​
Need Help?

Dashboard

Manage your account and API keys

Support

Get help from our support team

GitHub

View source code and contribute