# Forward Email Domains API

**Canonical:** https://apis.io/apis/forward-email/forward-email-domains-api/  
**Provider:** Forward Email — https://apis.io/providers/forward-email/  
**Base URL:** https://api.forwardemail.net  
**Documentation:** https://forwardemail.net/

Forward Email Domains API is one of 16 APIs that [Forward Email](https://apis.io/providers/forward-email/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Domains. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

> [!TIP] > Domain endpoints with a domain's name <code>/v1/domains/:domain\_name</code> as their endpoint are interchangeable with a domain's ID <code>:domain\_id</code>. This means you can refer to the domain by either its <code>name</code> or <code>id</code> value.

## Operations (13)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/domains` | List domains |
| POST | `/v1/domains` | Create domain |
| GET | `/v1/domains/{domain_id}` | Retrieve domain |
| PUT | `/v1/domains/{domain_id}` | Update domain |
| DELETE | `/v1/domains/{domain_id}` | Delete domain |
| GET | `/v1/domains/{domain_id}/verify-records` | Verify domain records |
| GET | `/v1/domains/{domain_id}/verify-smtp` | Verify domain SMTP records |
| POST | `/v1/domains/{domain_id}/test-s3-connection` | Test custom S3 connection |
| POST | `/v1/domains/{domain_id}/catch-all-passwords` | Create domain-wide catch-all password |
| GET | `/v1/domains/{domain_id}/catch-all-passwords` | List domain-wide catch-all passwords |
| DELETE | `/v1/domains/{domain_id}/catch-all-passwords/{token_id}` | Remove domain-wide catch-all password |
| PUT | `/v1/domains/{domain_id}/allowlist` | Update domain allowlist |
| PUT | `/v1/domains/{domain_id}/denylist` | Update domain denylist |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/forward-email/openapi/forward-email-domains-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/forward-email/json-schema/forward-email-domain-schema.json
- **JSONSchema** — https://artifacts.apis.io/forward-email/json-schema/forward-email-update-domain-input-schema.json
- **JSONSchema** — https://artifacts.apis.io/forward-email/json-schema/forward-email-message-schema.json
- **JSONSchema** — https://artifacts.apis.io/forward-email/json-schema/forward-email-smtp-schema.json
- **JSONSchema** — https://artifacts.apis.io/forward-email/json-schema/forward-email-alias-account-schema.json
- **JSONSchema** — https://artifacts.apis.io/forward-email/json-schema/forward-email-alias-input-schema.json

## Other Forward Email APIs (12)

- [Forward Email Account API](https://apis.io/apis/forward-email/forward-email-account-api/)
- [Forward Email Aliases API](https://apis.io/apis/forward-email/forward-email-aliases-api/)
- [Forward Email Calendar Events API](https://apis.io/apis/forward-email/forward-email-calendar-events-api/)
- [Forward Email Calendars API](https://apis.io/apis/forward-email/forward-email-calendars-api/)
- [Forward Email Contacts API](https://apis.io/apis/forward-email/forward-email-contacts-api/)
- [Forward Email Emails API](https://apis.io/apis/forward-email/forward-email-emails-api/)
- [Forward Email Encrypt API](https://apis.io/apis/forward-email/forward-email-encrypt-api/)
- [Forward Email Folders API](https://apis.io/apis/forward-email/forward-email-folders-api/)
- [Forward Email Invites API](https://apis.io/apis/forward-email/forward-email-invites-api/)
- [Forward Email Logs API](https://apis.io/apis/forward-email/forward-email-logs-api/)
- [Forward Email Members API](https://apis.io/apis/forward-email/forward-email-members-api/)
- [Forward Email Messages API](https://apis.io/apis/forward-email/forward-email-messages-api/)

## Tags

Domains

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/forward-email/forward-email-domains-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/forward-email/.