API Documentation

Complete reference for the PAAVS API.

Current Version: v1

Introduction

The PAAVS API allows you to manage domains, mailboxes, and users programmatically. It follows RESTful conventions and returns JSON responses.

Base URL https://api.paavs.com/api/v1

Authentication

Authenticate requests using a Bearer token. Tokens are obtained via the login endpoint.

POST /auth/login

Obtain an API token.

// Request
{
  "email": "[email protected]",
  "password": "yourpassword"
}

// Response
{
  "token": "eyJhbGcV...",
  "user": { ... }
}

Domains

Manage custom domains for email hosting.

GET /domains

List all registered domains.

POST /domains

Register a new domain.

// Request
{
  "name": "example.com"
}
POST /domains/{id}/verify

Trigger DNS verification for a domain. Checks SPF, DKIM, and MX records.

Mailboxes

Create and manage email accounts under your domains.

POST /mailboxes

Create a new mailbox.

// Request
{
  "domain_id": "uuid",
  "local_part": "admin", // [email protected]
  "password": "securePassword123",
  "quota_gb": 1
}