# inbound

## Docs

- [Download email attachment](https://inbound.new/docs/api-reference/attachments/download-email-attachment.md): Download an email attachment by email ID and filename. Returns the binary file content with appropriate Content-Type and Content-Disposition headers.
- [Create new domain](https://inbound.new/docs/api-reference/domains/create-new-domain.md): Add a new domain for email receiving. Automatically initiates verification and returns required DNS records. Subdomains inherit verification from their verified parent domain.
- [Delete domain](https://inbound.new/docs/api-reference/domains/delete-domain.md): Delete a domain and all associated resources including email addresses, DNS records, and SES configurations. Root domains with subdomains must have subdomains deleted first.
- [Get domain by ID](https://inbound.new/docs/api-reference/domains/get-domain-by-id.md): Get detailed information about a specific domain including DNS records. Use `?check=true` for a live verification check.
- [List all domains](https://inbound.new/docs/api-reference/domains/list-all-domains.md): Get paginated list of domains for authenticated user with optional filtering.
- [Update domain catch-all settings](https://inbound.new/docs/api-reference/domains/update-domain-catch-all-settings.md): Update catch-all email settings for a domain. Catch-all receives emails sent to any address on your domain. Domain must be verified first.
- [Create email address](https://inbound.new/docs/api-reference/email-addresses/create-email-address.md): Create a new email address for an authenticated user's domain, optionally routing to a webhook or endpoint.
- [Delete email address](https://inbound.new/docs/api-reference/email-addresses/delete-email-address.md): Delete an email address. Returns cleanup status.
- [Get email address](https://inbound.new/docs/api-reference/email-addresses/get-email-address.md): Get a specific email address by ID with detailed information including routing configuration
- [List all email addresses](https://inbound.new/docs/api-reference/email-addresses/list-all-email-addresses.md): Get paginated list of email addresses for authenticated user with optional filtering by domain, active status, and receipt rule configuration
- [Update email address](https://inbound.new/docs/api-reference/email-addresses/update-email-address.md): Update an email address's routing (endpoint/webhook) or active status. Cannot have both endpoint and webhook.
- [Cancel scheduled email](https://inbound.new/docs/api-reference/emails/cancel-scheduled-email.md): Cancel a scheduled email by ID. Only works for emails that haven't been sent yet.
- [Get email by ID](https://inbound.new/docs/api-reference/emails/get-email-by-id.md): Retrieve a single email by ID. Works for sent, received, and scheduled emails.
- [List all emails](https://inbound.new/docs/api-reference/emails/list-all-emails.md): List all email activity (sent, received, and scheduled) with comprehensive filtering options.
- [Reply to an email](https://inbound.new/docs/api-reference/emails/reply-to-an-email.md): Reply to an email or thread. Accepts either an email ID or thread ID (replies to latest message in thread). Supports reply all functionality.
- [Retry email delivery](https://inbound.new/docs/api-reference/emails/retry-email-delivery.md): Retry delivery of a received email. Can retry to a specific endpoint, retry a specific failed delivery, or retry to all configured endpoints.
- [Send an email](https://inbound.new/docs/api-reference/emails/send-an-email.md): Send an email immediately or schedule it for later using the scheduled_at parameter. Supports HTML/text content, attachments, and custom headers.
- [Update email](https://inbound.new/docs/api-reference/emails/update-email.md): Update metadata for a received email. Supports marking emails as read/unread and archived/unarchived.
- [Create new endpoint](https://inbound.new/docs/api-reference/endpoints/create-new-endpoint.md): Create a new endpoint (webhook, email, or email_group) for the authenticated user
- [Delete endpoint](https://inbound.new/docs/api-reference/endpoints/delete-endpoint.md): Delete an endpoint and clean up associated resources (email addresses become store-only, domains lose catch-all config, group entries and delivery history are deleted)
- [Get endpoint details](https://inbound.new/docs/api-reference/endpoints/get-endpoint-details.md): Get detailed information about a specific endpoint including delivery stats, recent deliveries, associated emails, and catch-all domains
- [List all endpoints](https://inbound.new/docs/api-reference/endpoints/list-all-endpoints.md): Get paginated list of endpoints for authenticated user with optional filtering by type, active status, sort order, and search by name
- [Test endpoint](https://inbound.new/docs/api-reference/endpoints/test-endpoint.md): Test an endpoint by sending a test payload. For webhooks, supports inbound, discord, and slack formats. For email endpoints, simulates the forwarding process.
- [Update endpoint](https://inbound.new/docs/api-reference/endpoints/update-endpoint.md): Update an existing endpoint's name, description, active status, config, or webhook format
- [Error Codes](https://inbound.new/docs/api-reference/errors.md): Comprehensive list of API error codes and their meanings
- [Check if rule matches email](https://inbound.new/docs/api-reference/guard/check-if-rule-matches-email.md): Test a guard rule against a specific email to see if it would match.
- [Create guard rule](https://inbound.new/docs/api-reference/guard/create-guard-rule.md): Create a new email filtering guard rule.
- [Delete guard rule](https://inbound.new/docs/api-reference/guard/delete-guard-rule.md): Delete a guard rule by ID.
- [Generate rule from natural language](https://inbound.new/docs/api-reference/guard/generate-rule-from-natural-language.md): Use AI to convert a natural language description into an explicit guard rule configuration.
- [Get guard rule](https://inbound.new/docs/api-reference/guard/get-guard-rule.md): Get a specific guard rule by ID.
- [List guard rules](https://inbound.new/docs/api-reference/guard/list-guard-rules.md): Get all guard rules for the authenticated user with optional filtering and pagination.
- [Update guard rule](https://inbound.new/docs/api-reference/guard/update-guard-rule.md): Update an existing guard rule.
- [Get thread by ID](https://inbound.new/docs/api-reference/inbox/get-thread-by-id.md): Retrieve a complete email thread (conversation) with all messages.
- [List inbox threads](https://inbound.new/docs/api-reference/inbox/list-inbox-threads.md): List email threads (conversations) for your inbox with cursor-based pagination. This is the primary endpoint for building an inbox UI.
- [Introduction](https://inbound.new/docs/api-reference/introduction.md): Simple email processing API for receiving and managing emails programmatically
- [Check for onboarding demo reply](https://inbound.new/docs/api-reference/onboarding/check-for-onboarding-demo-reply.md): Check if the user has replied to their onboarding demo email. Used during onboarding to detect reply.
- [Send onboarding demo email](https://inbound.new/docs/api-reference/onboarding/send-onboarding-demo-email.md): Send a demo email during onboarding to verify email setup. User must reply to complete onboarding.
- [Rate Limits](https://inbound.new/docs/api-reference/rate-limits.md): Understand rate limits and how to increase them for the Inbound API
- [Security](https://inbound.new/docs/api-reference/security.md): How to securely verify webhook requests from Inbound
- [Webhook Structure](https://inbound.new/docs/api-reference/webhook.md): Webhook payload structure
- [Email received](https://inbound.new/docs/api-reference/webhooks/email-received.md): When emails arrive at your configured addresses, Inbound sends a webhook to your endpoint with the complete email data.
- [Better Auth](https://inbound.new/docs/integrations/better-auth.md): Automatically send transactional emails for authentication events with Better Auth
- [MCP Server](https://inbound.new/docs/integrations/mcp.md): Connect AI assistants like Claude, Cursor, and OpenCode to your Inbound account
- [Getting Started](https://inbound.new/docs/quickstart/getting-started.md): Set up Inbound and send your first email in minutes
- [Introduction](https://inbound.new/docs/quickstart/introduction.md): Welcome to Inbound - the simple email processing API

## OpenAPI Specs

- [openapi.documented](https://app.stainless.com/api/spec/documented/inbound/openapi.documented.yml)