# UGMail -Developer Docs

> Build, integrate, and scale with the UGMail platform.

## Docs

- [AGENTS](https://docs.mail.ugmail.co/AGENTS.md)
- [Aliases API — Add Multiple Email Addresses to a Mailbox](https://docs.mail.ugmail.co/api-reference/aliases.md): Add and remove email aliases on any mailbox by updating the emails array via PATCH /api/principal/{name}. Route multiple addresses to one inbox.
- [API Authentication: Using Bearer Tokens with UGMail](https://docs.mail.ugmail.co/api-reference/authentication.md): All UGMail Management API requests require a Bearer token in the Authorization header. Get your token from Settings → API Connection at my.ugmail.co.
- [DKIM Configuration API — Enable Email Signing per Domain](https://docs.mail.ugmail.co/api-reference/dkim.md): Configure DKIM signing for your UGMail domains. Retrieve your DKIM public key from the DNS endpoint and add it as a TXT record at your registrar.
- [DNS Records API — Retrieve Required DNS Configuration](https://docs.mail.ugmail.co/api-reference/dns.md): Use GET /api/dns/{domain} to retrieve the exact MX, SPF, and DKIM records you must add at your registrar to activate email delivery for your UGMail domain.
- [Domains API — Create and Manage Custom Email Domains](https://docs.mail.ugmail.co/api-reference/domains.md): Create and manage custom email domains with the UGMail API. POST /api/principal to add a domain, GET to list or fetch, DELETE to remove.
- [Forwarders API — Redirect Incoming Email Automatically](https://docs.mail.ugmail.co/api-reference/forwarders.md): Create email forwarders that redirect incoming messages to another address. Manage forwarders via the UGMail API on any domain in your account.
- [Mailboxes API — Provision and Manage Email Accounts](https://docs.mail.ugmail.co/api-reference/mailboxes.md): Provision email accounts with POST /api/principal. Update passwords or aliases with PATCH. Remove accounts with DELETE. No per-user fees.
- [UGMail Management API — Complete Reference Overview](https://docs.mail.ugmail.co/api-reference/overview.md): The UGMail Management API is a REST API for creating domains, provisioning mailboxes, managing aliases and forwarders, and configuring DKIM.
- [UGMail Management API Authentication with Bearer Tokens](https://docs.mail.ugmail.co/authentication.md): UGMail uses Bearer token authentication for all Management API requests. Learn how to retrieve your token and use it securely in your app.
- [Email Aliases and Forwarders: Routing Mail in UGMail](https://docs.mail.ugmail.co/concepts/aliases-forwarders.md): Aliases let multiple addresses share one mailbox. Forwarders automatically redirect incoming messages to another address. Both are managed via the API.
- [DKIM Signing in UGMail: Authenticate Outbound Email](https://docs.mail.ugmail.co/concepts/dkim-signing.md): DKIM authenticates your outbound email with a cryptographic signature, improving deliverability and preventing spoofing. UGMail manages keys per domain.
- [UGMail Domains: Set Up and Manage Your Email Domain](https://docs.mail.ugmail.co/concepts/domains.md): A domain in UGMail is the foundation of your email infrastructure. Learn how domains are created, verified with DNS, and managed through the API.
- [UGMail Mailboxes: Provision Unlimited Email Accounts](https://docs.mail.ugmail.co/concepts/mailboxes.md): Mailboxes in UGMail are individual email accounts you provision via the API. Create unlimited mailboxes for users, agents, or automated workflows.
- [Send Email from AI Agents Using UGMail SMTP and IMAP](https://docs.mail.ugmail.co/guides/ai-agent-smtp.md): Give your AI agent its own dedicated email address using UGMail. Provision a mailbox via the API and connect your agent over SMTP in minutes.
- [Create and Manage Mailbox Aliases Using the UGMail API](https://docs.mail.ugmail.co/guides/manage-aliases.md): Add extra email addresses to any mailbox using aliases. Route support@, info@, and role-based addresses to the right inbox without creating extra accounts.
- [Provision a Mailbox Programmatically via UGMail API](https://docs.mail.ugmail.co/guides/provision-mailbox.md): Create a new email account on any of your domains using the UGMail Management API. Provision one mailbox or thousands in a single script.
- [Automate SaaS User Mailbox Provisioning with UGMail](https://docs.mail.ugmail.co/guides/saas-onboarding.md): Automatically create a dedicated mailbox for every new user or team in your SaaS app using the UGMail Management API during your onboarding flow.
- [Set Up a Custom Email Domain on UGMail Step by Step](https://docs.mail.ugmail.co/guides/setup-domain.md): Add a custom domain to UGMail, retrieve the required DNS records, and configure them in your registrar to start sending and receiving email.
- [UGMail — Programmatic Email Infrastructure for Developers](https://docs.mail.ugmail.co/index.md): UGMail gives you full programmatic control over email. Create domains, provision mailboxes, and connect via open protocols through a simple REST API.
- [UGMail: Programmatic Email Infrastructure Platform](https://docs.mail.ugmail.co/introduction.md): UGMail is a REST API-first email platform. Provision unlimited mailboxes, manage domains, and connect via SMTP, IMAP, JMAP, and more — no per-user fees.
- [Sync Calendars, Contacts, and Files on UGMail over HTTPS](https://docs.mail.ugmail.co/protocols/caldav-carddav-webdav.md): Sync calendars with CalDAV, contacts with CardDAV, and mount file storage with WebDAV — all on UGMail at mail.ugmail.co:443 over HTTPS.
- [Read and Sync Your Mailbox via IMAP on UGMail (Port 993)](https://docs.mail.ugmail.co/protocols/imap.md): Connect to UGMail's IMAP server at mail.ugmail.co:993 with SSL/TLS for full two-way mailbox sync with any email client or custom application.
- [Fast Batched Email API Access via JMAP on UGMail (Port 443)](https://docs.mail.ugmail.co/protocols/jmap.md): JMAP is a modern, efficient alternative to IMAP. Connect to UGMail's JMAP endpoint at mail.ugmail.co:443 for fast, batched email operations over HTTPS.
- [Open Email Protocols Supported by UGMail Mailboxes](https://docs.mail.ugmail.co/protocols/overview.md): UGMail supports seven open protocols — SMTP, IMAP, POP3, JMAP, CalDAV, CardDAV, and WebDAV — so you can connect any client without vendor lock-in.
- [Download Email to Your Device via POP3 on UGMail (Port 995)](https://docs.mail.ugmail.co/protocols/pop3.md): Connect to UGMail's POP3 server at mail.ugmail.co:995 with SSL/TLS to download messages locally. Best for offline or archival workflows.
- [Send Outbound Email via SMTP with UGMail (Port 587)](https://docs.mail.ugmail.co/protocols/smtp.md): Connect to UGMail's SMTP server at mail.ugmail.co:587 with STARTTLS to send transactional email, app notifications, and outbound messages from any mailbox.
- [UGMail Quickstart: Add a Domain and Send Your First Email](https://docs.mail.ugmail.co/quickstart.md): Create your UGMail account, get your API token, add your first domain, and provision a mailbox ready to send and receive email — in under a minute.
- [Security Overview: Protecting Your UGMail Account](https://docs.mail.ugmail.co/security/overview.md): UGMail offers two-factor authentication, app passwords, API token management, and domain-level email authentication (SPF, DKIM, DMARC) to keep your email infrastructure secure.
- [Configure SPF, DKIM, and DMARC for Email Authentication](https://docs.mail.ugmail.co/security/spf-dkim-dmarc.md): Set up SPF, DKIM, and DMARC DNS records for your UGMail domains to authenticate outbound email, prevent spoofing, and improve deliverability.
- [Enable Two-Factor Authentication on UGMail](https://docs.mail.ugmail.co/security/two-factor-auth.md): Add an extra layer of protection to your UGMail account with two-factor authentication (2FA). Set up a TOTP authenticator app in your account settings.
- [Lovable app integrat wn0y.bolt.host](https://docs.mail.ugmail.co/sources/site/lovable-app-integrat-wn0y.bolt.host/index.md)