List all domains in the postale.io account, with pagination (max 25 per page) and optional search query. Returns page info (page, lastPage, totalCount) plus domain objects.

Get a single domain's info: catch-all address, forward domain, mailbox/alias/storage limits, creation and update dates.

Add a domain to the postale.io account. Ownership is verified either via MX records already pointing to postale.io (verification='mx', default) or via a DNS TXT record (verification='txt'; get the record value first with get_domain_dns_record record='verification'). Optional limits are subject to your plan.

Update a domain's settings: catch-all address, forward domain, and mailbox/alias/storage limits. Only the provided fields are changed.

PERMANENTLY delete a domain and ALL of its mailboxes, including every stored email. This cannot be undone. Requires confirm=true.

Get a suggested DNS record for a domain, including the currently found value(s) so you can check whether DNS is configured correctly. Record types: 'mx' (mail routing), 'verification' (TXT record for adding the domain via TXT verification), 'dkim' (TXT, requires DKIM keys to exist), 'spf' (TXT), 'dmarc' (TXT), 'autoconfig' (CNAME, Thunderbird autoconfiguration), 'autodiscover' (CNAME, Outlook autodiscover).

Get the DKIM key pair (selector, public and private key) of a domain. Returns 404 if the domain has no DKIM keys.

Have postale.io generate a fresh DKIM key pair for a domain. After generating, publish the DNS record from get_domain_dns_record record='dkim'. Note: this replaces any existing keys.

Install a specific DKIM key pair (bring your own keys) for a domain, e.g. when migrating from another provider without changing DNS.

Remove the DKIM keys of a domain. Outgoing email will no longer be DKIM-signed. Requires confirm=true.

Get the white-label branding of a domain: brand name, logo URLs, favicon, support URL, admin URL visibility and webmail/admin styles.

Update the white-label branding of a domain. Only provided fields are changed. darkLogoUrl/menuLogoUrl/faviconUrl require logoUrl to be set. Styles accept login page gradient colors and custom CSS; adminStyle additionally accepts colorPrimary/colorSecondary.

Get the number of incoming and outgoing emails per day for a domain over the last 30 days.

List all mailboxes in the account across every domain, with pagination (max 25 per page) and optional search query. Returns address, name, disabled/admin flags, password strength and timestamps.

Get a single mailbox's info: name, disabled status, admin roles, password strength (0=very weak … 4=very strong, null=unknown) and timestamps.

Create a mailbox. The domain part of the address must already exist in the account. domainAdmin grants administration of the mailbox's domain; fullAdmin grants administration of the whole account.

Update a mailbox: display name, password, disabled status, or admin roles. Only the provided fields are changed.

PERMANENTLY delete a mailbox and ALL of its data, including every stored email. This cannot be undone. Requires confirm=true.

Get the Sieve filtering script of a mailbox (server-side email filtering rules, RFC 5228).

Replace the Sieve filtering script of a mailbox (RFC 5228 syntax). The whole script is replaced, so fetch the current one first with get_mailbox_sieve if you only want to add rules.

Get the quota of a mailbox: storage limit (GB), current storage usage (bytes) and number of emails stored.

Set the storage limit of a mailbox, in gigabytes.

Get the number of incoming and outgoing emails per day for a mailbox over the last 30 days.

List all aliases in the account, with pagination (max 25 per page) and optional search query. Each alias has an address and one or more redirect targets.

Get a single alias: its address, display name, redirect targets and timestamps.

Create an alias that redirects incoming email to one or more target addresses. The domain part of the alias address must already exist in the account.

Update an alias's display name and/or redirect targets. redirectTo replaces the full target list, so include every address that should remain.

Delete an alias. Email sent to it will bounce afterwards. Requires confirm=true.

List email log records for a given date (delivery attempts in and out): timestamps, remote/local IPs and ports, authenticated user, from/to addresses, redirections and subject. Paginated (max 25 per page) with optional search query. Use the record's id with get_email_log_protocol for the full SMTP transcript.

Get the raw SMTP/LMTP protocol transcript associated with an email log record — useful to diagnose delivery problems, rejections and bounces.

List authentication log records (IMAP/POP/SMTP/webmail logins) for a given date: timestamp, IP, email address and service. Paginated (max 25 per page) with optional search query. Useful for security audits and detecting unauthorized access.