Mailhooks
Mailhooks is a powerful email receiving API that lets you capture incoming emails and process them programmatically. Perfect for automation workflows, testing environments, transactional email handling, and building email-powered applications Email Reception & Management - Receive emails on custom domains or auto-generated addresses - Full email content retrieval (HTML, plain text, headers) -…
Mailhooks endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET |
MarketplaceStatusController_getStatus_v1 /api/v1/status |
Get marketplace account information including plan, usage, and limits |
| GET |
EmailsController_findOne_v1 /api/v1/emails/{id} |
Get a specific email by its ID. Optionally mark it as read. |
| GET |
EmailsController_downloadAttachment_v1 /api/v1/emails/{emailId}/attachments/{attachmentId} |
Download a specific attachment from an email |
| GET |
EmailsController_getEmailEml_v1 /api/v1/emails/{id}/eml |
Get the raw email in EML format |
| GET |
EmailsController_findAll_v1 /api/v1/emails |
Get paginated list of emails with optional filtering and sorting |
| GET |
WebhooksController_findAll_v1 /api/v1/webhooks |
|
| GET |
WebhooksController_findOne_v1 /api/v1/webhooks/{id} |
|
| DELETE |
WebhooksController_remove_v1 /api/v1/webhooks/{id} |
|
| POST |
WebhooksController_create_v1 /api/v1/webhooks |
|
| PUT |
WebhooksController_update_v1 /api/v1/webhooks/{id} |
|
| POST |
StorageConfigController_testConfig_v1 /api/v1/storage-config/test |
|
| GET |
StorageConfigController_getProviders_v1 /api/v1/storage-config/providers |
|
| GET |
StorageConfigController_getAllConfigs_v1 /api/v1/storage-config/all |
|
| PUT |
StorageConfigController_updateTenantConfig_v1 /api/v1/storage-config |
|
| GET |
StorageConfigController_checkPlanAccess_v1 /api/v1/storage-config/plan-access |
|
| GET |
StorageConfigController_getTenantConfig_v1 /api/v1/storage-config |
|
| DELETE |
StorageConfigController_deleteTenantConfig_v1 /api/v1/storage-config |
|
| GET |
List notification logs /api/v1/logs |
Retrieve unified logs for all hook types with pagination and filtering |
| GET |
Get webhook by ID /api/v1/webhooks/{id} |
Retrieve a specific webhook by ID |
| POST |
Create webhook /api/v1/webhooks |
Create a new webhook to receive email notifications via HTTP POST |
| GET |
List all domains /api/v1/domains |
Retrieve all domains configured for your account |
| GET |
Get domain by ID /api/v1/domains/{id} |
Retrieve details of a specific domain including verification status |
| POST |
Enable domain /api/v1/domains/{id}/enable |
Re-enable a disabled domain to resume receiving emails |
| POST |
Test storage connection /api/v1/storage-config/test |
Validate storage provider credentials and connectivity without persisting the configuration |
| GET |
Get storage configuration /api/v1/storage-config |
Retrieve the default storage configuration for your account |
| DELETE |
Delete storage configuration /api/v1/storage-config |
Remove custom storage configuration and revert to platform storage |
| PUT |
Update storage configuration /api/v1/storage-config |
Modify the storage provider settings or credentials for your account |
| POST |
Create storage configuration /api/v1/storage-config |
Configure a custom storage provider to store email attachments and content |
| GET |
List all storage configurations /api/v1/storage-config/all |
Retrieve all storage configurations including both account-level and domain-specific settings |
| GET |
Check storage access /api/v1/storage-config/plan-access |
Verify whether your current subscription plan includes the ability to configure custom storage providers |
| GET |
List storage providers /api/v1/storage-config/providers |
Get a list of all supported external storage providers (S3, GCS, Azure Blob, etc.) with their required configuration fields |
| POST |
Create domain /api/v1/domains |
Add a new custom domain to your account. After creating, configure DNS records and verify ownership. |
| DELETE |
Delete domain /api/v1/domains/{id} |
Remove a domain from your account. This will stop all email reception for this domain. |
| POST |
Disable domain /api/v1/domains/{id}/disable |
Temporarily disable a domain to stop receiving emails |
| POST |
Verify domain /api/v1/domains/{domain}/verify |
Trigger DNS verification check for a domain |
| GET |
Get registration status /api/v1/marketplace/account/status |
Check if an email has been registered for this marketplace account. |
| GET |
Get account status /api/v1/status |
Get marketplace account information including plan, usage, and limits |
| GET |
List all webhooks /api/v1/webhooks |
Retrieve all webhooks configured for your account |
| DELETE |
Delete webhook /api/v1/webhooks/{id} |
Permanently delete a webhook |
| POST |
Register email /api/v1/marketplace/account/register-email |
Register an email address for your marketplace account to enable dashboard access. This can only be done once per account. A verification link will be sent to the email. |
| POST |
Request magic link /api/v1/marketplace/account/request-magic-link |
Request a magic link to login to the Mailhooks dashboard. The link will be sent to the registered email address. |
| GET |
Subscribe to push notifications /api/v1/realtime/events |
Establishes a Server-Sent Events (SSE) connection for push notifications when emails arrive. **Connection Modes:** - `broadcast` (default): All connected clients receive every… |
| GET |
Get email lifecycle logs /api/v1/logs/email/{emailId} |
Retrieve all logs for a specific email, showing the complete processing lifecycle (SMTP reception, spam check, webhook delivery, etc.) |
| GET |
Get email content /api/v1/emails/{id}/content |
Get the HTML and text content of an email |
| GET |
Get domain by ID /api/v1/domains/{id} |
Retrieve details of a specific domain including verification status |
| POST |
Disable domain /api/v1/domains/{id}/disable |
Temporarily disable a domain to stop receiving emails |
| POST |
Enable domain /api/v1/domains/{id}/enable |
Re-enable a disabled domain to resume receiving emails |
| GET |
Get email by ID /api/v1/emails/{id} |
Get a specific email by its ID. Optionally mark it as read. |
| GET |
List all emails /api/v1/emails |
Get paginated list of emails with optional filtering and sorting |
| GET |
Download email as EML /api/v1/emails/{id}/eml |
Get the raw email in EML format |
Mailhooks pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO Recommended | $10 / month | — |
|
| ULTRA | $49 / month | — |
|