> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mail.ugmail.co/llms.txt
> Use this file to discover all available pages before exploring further.

# UGMail — Programmatic Email Infrastructure for Developers

> UGMail gives you full programmatic control over email. Create domains, provision mailboxes, and connect via open protocols through a simple REST API.

UGMail is a programmatic email infrastructure platform built for developers and businesses that need full control over their email stack. With a single REST API call you can create domains, provision unlimited mailboxes, configure DKIM, and connect any client or application through seven open protocols — no per-user fees, no vendor lock-in, and a 99.99% uptime SLA.

## Get started fast

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Create an account, add a domain, and provision your first mailbox in under a minute.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/overview">
    Explore every endpoint in the UGMail Management REST API.
  </Card>

  <Card title="Protocols Overview" icon="network-wired" href="/protocols/overview">
    Connect via SMTP, IMAP, POP3, JMAP, CalDAV, CardDAV, or WebDAV.
  </Card>

  <Card title="Set Up a Domain" icon="globe" href="/guides/setup-domain">
    Add a domain, fetch DNS records, and go live in minutes.
  </Card>
</CardGroup>

## How it works

<Steps>
  <Step title="Get your Bearer token">
    Sign in at [my.ugmail.co](https://my.ugmail.co), go to **Settings → API Connection**, and copy your tenant-scoped Bearer token. Every Management API request uses this token.
  </Step>

  <Step title="Add a domain">
    Call `POST /api/principal` with `"type": "domain"` to register your domain, then fetch the required DNS records from `GET /api/dns/{domain}` and add them at your registrar.
  </Step>

  <Step title="Provision a mailbox">
    Call `POST /api/principal` with `"type": "individual"` to create a mailbox. Set a secure password and assign one or more email addresses — done in a single request.
  </Step>

  <Step title="Connect your client or application">
    Use any standard email client or library. Point it to `mail.ugmail.co` on the protocol port that suits your use case: SMTP (587), IMAP (993), JMAP (443), and more.
  </Step>
</Steps>

## Explore the platform

<CardGroup cols={2}>
  <Card title="Domains" icon="layer-group" href="/concepts/domains">
    Understand how domains, DNS records, and DKIM signing work in UGMail.
  </Card>

  <Card title="Mailboxes" icon="inbox" href="/concepts/mailboxes">
    Learn about mailbox types, aliases, forwarders, and storage.
  </Card>

  <Card title="Security" icon="shield-halved" href="/security/overview">
    Review authentication, encryption, tenant isolation, and compliance.
  </Card>

  <Card title="AI Agent Email" icon="robot" href="/guides/ai-agent-smtp">
    Give your AI agents a real mailbox and send email programmatically via SMTP.
  </Card>
</CardGroup>