Get started fast
Quickstart
Create an account, add a domain, and provision your first mailbox in under a minute.
API Reference
Explore every endpoint in the UGMail Management REST API.
Protocols Overview
Connect via SMTP, IMAP, POP3, JMAP, CalDAV, CardDAV, or WebDAV.
Set Up a Domain
Add a domain, fetch DNS records, and go live in minutes.
How it works
1
Get your Bearer token
Sign in at my.ugmail.co, go to Settings → API Connection, and copy your tenant-scoped Bearer token. Every Management API request uses this token.
2
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.3
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.4
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.Explore the platform
Domains
Understand how domains, DNS records, and DKIM signing work in UGMail.
Mailboxes
Learn about mailbox types, aliases, forwarders, and storage.
Security
Review authentication, encryption, tenant isolation, and compliance.
AI Agent Email
Give your AI agents a real mailbox and send email programmatically via SMTP.

