Galon Cloud
Galon API v1

/domains

Base URL https://api.galon.ai/v1 · export GALON_API_BASE="https://api.galon.ai/v1"

GET /domains

List Galon Mail sending domains

Compatible with the Galon Mail sending domain list. Requires a full_access key.

API key (Bearer), on the public API endpoint.

Responses

StatusDescriptionBody
200List of sending domainsMailDomainListResponse
401Key missing or invalidError
403api_key_permission_insufficient
503mail_domains_unavailable

Examples

curl

curl -X GET "$GALON_API_BASE/domains" \
  -H "Authorization: Bearer $GALON_API_KEY"

Node.js (SDK)

import { Galon } from "galon";

const galon = new Galon(process.env.GALON_API_KEY);
const result = await galon.domains.list({ limit: 20 });

Python (SDK)

from galon import Galon

galon = Galon()  # reads GALON_API_KEY
result = galon.domains.list({"limit": 20})

POST /domains

Add a Galon Mail sending domain

Compatible with the Galon Mail API. Requires a full_access key; returns the DNS records to publish.

API key (Bearer), on the public API endpoint.

Request body

application/json · schema MailDomainCreate

FieldTypeDescription
namestring · required
regionstring
tls"opportunistic" | "enforced"
custom_return_pathstring
open_trackingboolean
click_trackingboolean
bimiMailDomainBimi | null

Responses

StatusDescriptionBody
201Sending domain and DNS recordsMailDomain
401Key missing or invalidError
403api_key_permission_insufficient
409domain_already_exists
422Invalid parametersError
503mail_domains_unavailable

Examples

curl

curl -X POST "$GALON_API_BASE/domains" \
  -H "Authorization: Bearer $GALON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "string"}'

Node.js (SDK)

import { Galon } from "galon";

const galon = new Galon(process.env.GALON_API_KEY);
const result = await galon.domains.create({"name": "string"});

Python (SDK)

from galon import Galon

galon = Galon()  # reads GALON_API_KEY
result = galon.domains.create({"name": "string"})