API Documentation

Authentication

All API requests require authentication using JWT tokens.

{
  "email": "user@example.com",
  "password": "your-password"
}

Response:

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires_at": "2026-02-17T15:23:45Z"
}

Include the token in all subsequent requests:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Email Aliases

List Aliases

{
  "aliases": [
    {
      "id": "uuid-here",
      "alias_email": "alias@msgs.global",
      "forward_to": "you@gmail.com",
      "enabled": true,
      "created_at": "2026-01-15T10:30:00Z"
    }
  ],
  "count": 1
}

Create Alias

{
  "alias_email": "myalias@msgs.global",
  "forward_to": "destination@example.com"
}

Update Alias

{
  "enabled": false,
  "forward_to": "newemail@example.com"
}

Delete Alias

Custom Domains

Add Domain

{
  "domain": "mydomain.com"
}

Response includes verification token:

{
  "domain_id": "uuid-here",
  "domain": "mydomain.com",
  "verification_token": "verify-token-123",
  "txt_record": "_msgs-verify.mydomain.com",
  "instructions": "Add TXT record with verification token"
}

Verify Domain

Email Logs

List Email Logs

{
  "emails": [
    {
      "id": "uuid",
      "from_email": "sender@example.com",
      "to_email": "alias@msgs.global",
      "subject": "Email subject",
      "verdict": "clean",
      "spam_score": 2.5,
      "phishing_score": 0.1,
      "processed_at": "2026-02-16T14:30:00Z"
    }
  ]
}

Quarantine Management

List Quarantined Emails

Release from Quarantine

{
  "action": "release"
}

Admin API

Admin endpoints require @afterdarksys.com email

Platform Statistics

Pending Approvals

Approve Domain

{
  "approved": true
}

Webhooks

Configure webhooks to receive real-time notifications

Email Received

{
  "event": "email.received",
  "timestamp": "2026-02-16T14:30:00Z",
  "data": {
    "alias_id": "uuid",
    "from": "sender@example.com",
    "verdict": "clean"
  }
}

Email Quarantined

{
  "event": "email.quarantined",
  "timestamp": "2026-02-16T14:30:00Z",
  "data": {
    "alias_id": "uuid",
    "from": "sender@example.com",
    "reason": "high_spam_score"
  }
}

Error Codes