Email

Activate hosted email domains, administer mailboxes, and retrieve sanitized client settings. A domain can host email without being mapped to a website.

Domain lifecycle

• email_get_capacity shows the plan’s email-domain and storage capacity.
• email_activate_domain enables an eligible domain and creates its postmaster credential.
• email_deactivate_domain uses the current platform removal flow and therefore requires acknowledgement that all mailbox data will be deleted.
• email_delete_domain permanently deletes the email service and its mailboxes.

Mailbox lifecycle

• email_create_mailbox creates a mailbox with a caller-supplied password, quota, first name, and last name.
• email_update_mailbox_profile changes first and last name without requiring the mailbox password.
• email_update_mailbox_quota changes the mailbox quota within plan limits; use quotaMb: 0 for the provider's unlimited setting.
• email_rotate_credential sets a new caller-supplied password; email_revoke_credential replaces it with an unretrievable random value.
• email_delete_mailbox permanently deletes a non-postmaster mailbox after exact confirmation.

Mail client settings

email_get_smtp_settings returns public SMTP, IMAP, and POP endpoints, ports, and TLS guidance without returning credentials. email_test_smtp accepts the current password only for a same-mailbox authentication and delivery test; it cannot send to an arbitrary recipient.