Galon Cloud
Galon Cloud

Email with your AI agent

Your agent sets up a sending domain, sends email from your app's project and checks what was delivered.

Markdown · API reference · OpenAPI

What your agent can do

  • Send an email, safely retried with the same idempotency_key.
  • List sent emails and read the delivery status of each.
  • Add a sending domain, give you its DNS records, then verify it.
  • Create and publish email templates, and manage suppressed addresses.

Ask your agent

Paste a request like these in your AI once it is connected. It calls the tools in this order.

You askYour agent calls
“Send a welcome email to ana@example.com from hello@acme.com.”get_status → send_email → get_email
“Set up mail.acme.com to send email.”list_domains → add_domain → get_domain → verify_domain
“Did any of my last emails bounce?”list_emails → get_email
“Create a welcome template and publish it.”create_template → publish_template

Tools and routes

Every tool is a call to the REST route next to it, with the same permissions, limits and idempotency. tools/list shows only the tools your connection can call.

ToolWhat it doesScopeSame through the REST API
get_statusProject, environment, sending mode and the services open to this key.noneGET /v1/tools
send_emailSend one email.mail:sendPOST /v1/emails
list_emailsList sent emails, newest first.mail:send, job:readGET /v1/emails
get_emailRead one sent email and its status.mail:send, job:readGET /v1/emails/{email_id}
list_domainsList sending domains and their status.full_accessGET /v1/domains
add_domainAdd a sending domain.full_accessPOST /v1/domains
get_domainRead a sending domain and its DNS records.full_accessGET /v1/domains/{domain_id}
verify_domainCheck a domain's DNS records now.full_accessPOST /v1/domains/{domain_id}/verify
list_templatesList email templates.template:readGET /v1/templates
create_templateCreate a template draft.template:writePOST /v1/templates
publish_templatePublish a template so send_email can use it.template:writePOST /v1/templates/{template}/publish
list_suppressionsList addresses that will not receive email.full_accessGET /v1/suppressions
add_suppressionStop all email to these addresses.full_accessPOST /v1/suppressions

Limits, free tier and pricing

Read from the platform code each time this page is served.

LimitValue
Recipients per email (to, cc and bcc together)50
Attachments per email10
Email size after encoding, attachments included25 MB
Emails per batch request100
Scheduling horizon (scheduled_at)3 days
Text or HTML body, each48 KiB
Message size after encoding, attachments included25 MB

Free plan (no card): 3,000 transactional emails a month, 100 a day. Hard limits: a send beyond them is refused, never billed.

Paid plans, per month, in US dollars. The plan's monthly volume is a hard limit: there is no overage billing.

PlanPrice per monthEmails per month
starter5.39 USD10,000
pro_50k15.00 USD50,000
pro_100k27.00 USD100,000
scale_250k62.00 USD250,000
scale_500k115.00 USD500,000
scale_1m210.00 USD1,000,000
scale_2_5m475.00 USD2,500,000

Your agent reads the current prices with get_pricing and the spending limits with get_limits.

Good to know

  • Nothing is sent from an unverified domain: the DNS records are published at your DNS host, then verified.
  • Domains and suppressions need a connection with full_access; sending needs mail:send.

Next