# Hostingsurge Email API **Canonical:** https://apis.io/apis/hostingsurge-com/hostingsurge-com-email-api/ **Provider:** Hostingsurge — https://apis.io/providers/hostingsurge-com/ **Base URL:** https://hostingsurge.com/api/v1 **Documentation:** https://hostingsurge.com/developers Hostingsurge Email API is one of 37 APIs that [Hostingsurge](https://apis.io/providers/hostingsurge-com/) 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 Email. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas. The Email API from Hostingsurge — 27 operation(s) for email. ## Operations (36) | Method | Path | Summary | |---|---|---| | GET | `/email/domains` | Email domains: ownership, mailbox and sending status, DNS to publish | | POST | `/email/domains` | Add a domain (a domain you own; not hostingsurge.com/.app). | | GET | `/email/domains/{domainId}` | One domain with its full DNS plan and live check | | DELETE | `/email/domains/{domainId}` | Remove a domain (best-effort mailcow cleanup) | | POST | `/email/domains/{domainId}/verify` | Re-check DNS: verifies ownership if not yet proven, and activates… | | POST | `/email/domains/{domainId}/mailboxes/enable` | Enable or disable mailboxes on mailcow for this domain | | POST | `/email/domains/{domainId}/sending/enable` | Enable or disable transactional sending on Postal for this domain (the… | | POST | `/email/domains/{domainId}/cloudflare/preview` | DNS at Cloudflare: what one click would write (MX, SPF, DKIM, DMARC) and what… | | POST | `/email/domains/{domainId}/cloudflare/apply` | DNS at Cloudflare: write the plan of the preview (its planHash). | | GET | `/email/domains/{domainId}/mailboxes` | Mailboxes of a domain, with mailcow quota usage | | POST | `/email/domains/{domainId}/mailboxes` | Create a mailbox. | | PATCH | `/email/mailboxes/{mailboxId}` | Change password, quota, name or active state | | DELETE | `/email/mailboxes/{mailboxId}` | Delete a mailbox (best-effort mailcow cleanup) | | GET | `/email/domains/{domainId}/aliases` | Aliases and the catch-all address of a domain | | POST | `/email/domains/{domainId}/aliases` | Create an alias or the domain catch-all | | PATCH | `/email/aliases/{aliasId}` | Change destinations or active state | | DELETE | `/email/aliases/{aliasId}` | Delete an alias | | GET | `/email/mailboxes/{mailboxId}/sync-jobs` | IMAP import jobs of a mailbox | | POST | `/email/mailboxes/{mailboxId}/sync-jobs` | Import an existing mailbox over IMAP (mailcow syncjob). | | DELETE | `/email/sync-jobs/{syncJobId}` | Cancel/remove an import job | | GET | `/email/sending` | Transactional sending status for your organization (on once a sending domain… | | GET | `/email/usage` | Transactional email quota and usage: recipients today (UTC), this billing… | | POST | `/email/sending/request` | Optional note for the operator: sending turns on by itself once a sending… | | POST | `/email/sending/operator` | Platform operator only: enable (optionally overriding the daily/monthly quota)… | | POST | `/email/sending/credential` | Create (rotate) an SMTP credential for postal.hostingsurge.com:587. | | GET | `/email/messages` | Recent transactional sends (this platform's own log; see docs/EMAIL.md) | | GET | `/email/messages/{messageId}/deliveries` | Live delivery attempts for one message, from Postal | | POST | `/emails` | Send a transactional email through Postal. | | GET | `/projects/{projectId}/site-email` | Email of the website's domains: state, DNS records, last 7 days for each | | POST | `/projects/{projectId}/site-email` | Set up email for one domain of this website: creates the sending domain and… | | PUT | `/projects/{projectId}/site-email/account` | Connect the team's own Resend account with a Full access key, or replace the… | | DELETE | `/projects/{projectId}/site-email/account` | Forget the team's Resend key. Domains that already send keep their own keys | | POST | `/projects/{projectId}/site-email/check` | Check the DNS records of every domain still waiting; once one verifies, the… | | POST | `/projects/{projectId}/site-email/{domain}/dns/cloudflare` | Add this domain's mail records at Cloudflare with an API token you paste. | | POST | `/projects/{projectId}/site-email/{domain}/resume` | Resume this domain after a pause | | DELETE | `/projects/{projectId}/site-email/{domain}` | Stop this domain's email: revokes the key, removes the domain and its two… | ## Machine-readable artifacts (7) - **OpenAPI** — https://artifacts.apis.io/hostingsurge-com/openapi/hostingsurge-com-email-api-openapi.yml - **JSONSchema** — https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-builder-visual-op-schema.json - **JSONSchema** — https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-policy-templates-input-body-schema.json - **JSONSchema** — https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-pending-changes-input-body-schema.json - **JSONSchema** — https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-confirm-prices-input-body-schema.json - **JSONSchema** — https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-collection-input-body-schema.json - **JSONSchema** — https://artifacts.apis.io/hostingsurge-com/json-schema/hostingsurge-com-create-shop-input-body-schema.json ## Other Hostingsurge APIs (12) - [Hostingsurge Accelerator API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-accelerator-api/) - [Hostingsurge Agents API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-agents-api/) - [Hostingsurge Alerts API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-alerts-api/) - [Hostingsurge Analytics API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-analytics-api/) - [Hostingsurge Assistant API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-assistant-api/) - [Hostingsurge Automation API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-automation-api/) - [Hostingsurge Backups API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-backups-api/) - [Hostingsurge Billing API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-billing-api/) - [Hostingsurge Builder API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-builder-api/) - [Hostingsurge Business API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-business-api/) - [Hostingsurge Certificates API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-certificates-api/) - [Hostingsurge Databases API](https://apis.io/apis/hostingsurge-com/hostingsurge-com-databases-api/) ## Tags Email --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/hostingsurge-com/hostingsurge-com-email-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/hostingsurge-com/.