# Galon Mail > Send transactional email from your app or your coding agent: verified sending domains, templates, suppressions and signed webhooks, through one API key or MCP. Server side only: read the key from the `GALON_API_KEY` environment variable. Call `GET https://api.galon.ai/v1/tools` first: use only what it lists for this key. Send an `Idempotency-Key` with every write and reuse it on retry. On an error, act on `detail.code` and follow `detail.next_action`. ## What it does - Send transactional email by REST or the MCP tool send_email, with an idempotency key on every write. - Verify a sending domain: the API returns the DNS records to publish, then checks them. - Templates, suppressions, delivery status and signed webhooks for each event. - Address validation, deliverability reports, inbound email and archive for full-access keys. ## API - `POST /v1/emails`: Send an email - `GET /v1/emails`: List emails - `GET /v1/emails/metrics`: Get daily log metrics over at most 92 days - `GET /v1/emails/bounce-reasons`: Project bounce reasons over 7 or 30 days - `GET /v1/deliverability`: Deliverability by mailbox provider for the key's project (Gmail, Microsoft, Yahoo/AOL, Apple, Orange, others) over 7 and 30 days - `POST /v1/emails/batch`: Send a batch of emails - `POST /v1/emails/{job_id}/cancel`: Cancel a send still queued (scheduled or not) - `GET /v1/emails/{email_id}`: Read an email - `PATCH /v1/emails/{email_id}`: Reschedule an email before the worker picks it up - `POST /v1/templates`: Create a template - `GET /v1/templates`: List templates - `GET /v1/templates/{template}`: Read a template - `PATCH /v1/templates/{template}`: Update only a template's draft - `DELETE /v1/templates/{template}`: Delete a template and its versions - `POST /v1/templates/{template}/publish`: Publish a template - `POST /v1/templates/{template}/duplicate`: Duplicate the draft into a new unpublished template without an alias - `POST /v1/domains/claim`: Claim a domain already registered by another account (DNS proof): returns the TXT record to publish; no information about the holder - `GET /v1/domains/claims/{claim_id}`: Get a domain claim - `POST /v1/domains/claims/{claim_id}/verify`: Check the TXT record and conclude: transferred (a NEW identity, to be verified, in the project) or blocked (domain active on another account) - `POST /v1/email-validations`: Validate email addresses (syntax, role, disposable domain, typo, MX) - `POST /v1/domains`: Add a domain - `GET /v1/domains`: List domains - `GET /v1/domains/{domain_id}`: Read a domain - `PATCH /v1/domains/{domain_id}`: Update the mutable options of a sending domain - `DELETE /v1/domains/{domain_id}`: Delete a domain after exact confirmation - `POST /v1/domains/{domain_id}/verify`: Verify a domain - `POST /v1/suppressions`: Add suppressions - `GET /v1/suppressions`: List suppressions - `DELETE /v1/suppressions/{target}`: Remove an address from the suppression list - `GET /v1/received-emails`: List received emails - `GET /v1/received-emails/{email_id}`: Get a received email - `GET /v1/received-emails/{email_id}/attachments`: List a received email's attachments - `GET /v1/received-emails/{email_id}/attachments/{attachment_id}`: Download an attachment - `POST /v1/received-emails/{email_id}/forward`: Forward a received email - `GET /v1/receiving-domains`: List inbound domains - `POST /v1/receiving-domains`: Register an inbound domain - `GET /v1/receiving-domains/{domain_id}`: Get an inbound domain - `PATCH /v1/receiving-domains/{domain_id}`: Enable or disable an inbound domain - `DELETE /v1/receiving-domains/{domain_id}`: Remove an inbound domain - `GET /v1/receiving-domains/{domain_id}/rules`: List a domain's forwarding rules - `POST /v1/receiving-domains/{domain_id}/rules`: Create a forwarding rule - `PATCH /v1/receiving-domains/{domain_id}/rules/{rule_id}`: Enable or disable a forwarding rule - `DELETE /v1/receiving-domains/{domain_id}/rules/{rule_id}`: Delete a forwarding rule - `GET /v1/mail-pro/domains`: List mailbox domains - `POST /v1/mail-pro/domains`: Add a mailbox domain - `GET /v1/mail-pro/domains/{domain_id}`: Read a mailbox domain - `DELETE /v1/mail-pro/domains/{domain_id}`: Remove a Mail Pro domain - `POST /v1/mail-pro/domains/{domain_id}/verify`: Verify a mailbox domain - `GET /v1/mail-pro/mailboxes`: List mailboxes - `POST /v1/mail-pro/mailboxes`: Create a mailbox - `GET /v1/mail-pro/mailboxes/{mailbox_id}`: Read a mailbox - `PATCH /v1/mail-pro/mailboxes/{mailbox_id}`: Change a mailbox's quota - `DELETE /v1/mail-pro/mailboxes/{mailbox_id}`: Delete a mailbox (reversible for 30 days) - `POST /v1/mail-pro/mailboxes/{mailbox_id}/suspend`: Suspend a mailbox - `POST /v1/mail-pro/mailboxes/{mailbox_id}/resume`: Reactivate a mailbox - `POST /v1/mail-pro/mailboxes/{mailbox_id}/aliases`: Add an alias to a mailbox - `DELETE /v1/mail-pro/mailboxes/{mailbox_id}/aliases/{address}`: Remove an alias - `POST /v1/mail-pro/mailboxes/{mailbox_id}/password`: Change a mailbox's password - `POST /v1/mail-pro/mailboxes/{mailbox_id}/activation-link`: Send an activation link - `POST /v1/mail-pro/domains/{rid}/storage`: Buy storage for a domain ## MCP tools Server: `https://api.galon.ai/v1/mcp` (Streamable HTTP). - `send_email`: Send one email. - `list_emails`: List sent emails, newest first. - `get_email`: Read one sent email and its status. - `list_domains`: List sending domains and their status. - `add_domain`: Add a sending domain. - `get_domain`: Read a sending domain and its DNS records. - `verify_domain`: Check a domain's DNS records now. - `list_suppressions`: List addresses that will not receive email. - `add_suppression`: Stop all email to these addresses. - `list_templates`: List email templates. - `create_template`: Create a template draft. - `get_template`: Read a template by id or alias. - `publish_template`: Publish a template so send_email can use it. ## Docs - [Galon Mail guide](/cloud/docs/services/mail) - [OpenAPI 3.1 contract](/cloud/docs/openapi.json): the source of truth for routes and fields - [Complete LLM integration guide](/llms-full.txt)