Developer Settings & API Keys

Back to Mail

Configured Email Domain

Allowed Service Domain: divadivya.cloud

Only incoming emails targeting @divadivya.cloud will trigger webhooks, and outgoing emails will carry DKIM signatures for this domain.

Create API Key with Permissions

Generate a new API key mapped to a specific mailbox, password, and permission scope.

Active API Keys

API Key ID Associated Mailbox Scopes / Permissions Action

Webhook Notifications

Specify an external webhook endpoint. A JSON payload is POSTed here instantly when new incoming emails are received.

Update Current Mailbox Password

Use this after changing the mailbox password in Mailcow. This updates only the password saved inside this mail proxy for your current API key.

Quick Code Integrations

Send Email (Curl):

curl -X POST http://<your-vps-ip>:8000/api/send \
  -H "X-API-KEY: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "client@example.com",
    "subject": "AI Automated Response",
    "body": "Hello! This is a test email sent from our self-hosted proxy."
  }'

Download Attachment:

# Download the 1st attachment of email with UID 43
curl -X GET http://<your-vps-ip>:8000/api/attachment/43/1 \
  -H "X-API-KEY: <your-api-key>" \
  --output invoice.pdf