# openmail-sh Domains API

**Canonical:** https://apis.io/apis/openmail-sh/openmail-sh-domains-api/  
**Provider:** openmail-sh — https://apis.io/providers/openmail-sh/  
**Base URL:** https://api.openmail.sh  
**Documentation:** https://docs.openmail.sh/api-reference/introduction

openmail-sh Domains API is one of 10 APIs that [openmail-sh](https://apis.io/providers/openmail-sh/) 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.

Custom domains: add your own sending/receiving domain, publish DNS, and verify it

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/domains` | Add custom domain |
| GET | `/v1/domains` | List custom domains |
| GET | `/v1/domains/{id}` | Get custom domain |
| PATCH | `/v1/domains/{id}` | Change custom domain pod scope |
| DELETE | `/v1/domains/{id}` | Delete custom domain |
| POST | `/v1/domains/{id}/verify` | Re-check custom domain |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/openmail-sh/openapi/openmail-sh-domains-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/openmail-sh/json-schema/openmail-sh-cold-cap-limits-schema.json
- **JSONSchema** — https://artifacts.apis.io/openmail-sh/json-schema/openmail-sh-message-schema.json
- **JSONSchema** — https://artifacts.apis.io/openmail-sh/json-schema/openmail-sh-inbox-schema.json
- **JSONSchema** — https://artifacts.apis.io/openmail-sh/json-schema/openmail-sh-domain-schema.json
- **JSONSchema** — https://artifacts.apis.io/openmail-sh/json-schema/openmail-sh-owned-domain-schema.json
- **JSONSchema** — https://artifacts.apis.io/openmail-sh/json-schema/openmail-sh-api-key-schema.json

## Other openmail-sh APIs (9)

- [openmail-sh Attachments API](https://apis.io/apis/openmail-sh/openmail-sh-attachments-api/)
- [openmail-sh Feedback API](https://apis.io/apis/openmail-sh/openmail-sh-feedback-api/)
- [openmail-sh Inboxes API](https://apis.io/apis/openmail-sh/openmail-sh-inboxes-api/)
- [openmail-sh Limits API](https://apis.io/apis/openmail-sh/openmail-sh-limits-api/)
- [openmail-sh Messages API](https://apis.io/apis/openmail-sh/openmail-sh-messages-api/)
- [openmail-sh Owned Domains API](https://apis.io/apis/openmail-sh/openmail-sh-owned-domains-api/)
- [openmail-sh Pods API](https://apis.io/apis/openmail-sh/openmail-sh-pods-api/)
- [openmail-sh Policy API](https://apis.io/apis/openmail-sh/openmail-sh-policy-api/)
- [openmail-sh Threads API](https://apis.io/apis/openmail-sh/openmail-sh-threads-api/)

## Tags

domains

---

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