🚀 Getting Started
The HostingEmails API allows you to programmatically manage email accounts, domains, and settings. All requests require authentication via API key.
Base URL
https://api.hostingemails.net/v1
Authentication
Include your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEY
Note: Keep your API key secure. Never share it publicly or commit it to version control.
📧 Email Accounts
GET
/accounts
List all email accounts
POST
/accounts
Create a new email account
GET
/accounts/{id}
Get account details
DELETE
/accounts/{id}
Delete an email account
Example Request
curl -X POST https://api.hostingemails.net/v1/accounts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"email": "john@example.com",
"password": "SecurePass123",
"storage_quota": 10240
}'
🌐 Domains
GET
/domains
List all domains
POST
/domains
Add a new domain
POST
/domains/{id}/verify
Verify domain ownership
📊 Response Format
All API responses are in JSON format:
{
"success": true,
"data": { ... },
"message": "Operation completed successfully"
}
Error Responses
{
"success": false,
"error": {
"code": 401,
"message": "Invalid API key"
}
}
Common Status Codes
200 OK - Request succeeded
201 Created - Resource created successfully
400 Bad Request - Invalid request parameters
401 Unauthorized - Invalid or missing API key
404 Not Found - Resource not found
429 Too Many Requests - Rate limit exceeded
500 Internal Server Error - Server error
🔑 Get Your API Key
API access is available on Professional and Enterprise plans.
Generate your API key from your account dashboard after upgrading to a compatible plan.