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
| Status | Description | Body |
|---|---|---|
200 | List of sending domains | MailDomainListResponse |
401 | Key missing or invalid | Error |
403 | api_key_permission_insufficient | |
503 | mail_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
| Field | Type | Description |
|---|---|---|
name | string · required | |
region | string | |
tls | "opportunistic" | "enforced" | |
custom_return_path | string | |
open_tracking | boolean | |
click_tracking | boolean | |
bimi | MailDomainBimi | null |
Responses
| Status | Description | Body |
|---|---|---|
201 | Sending domain and DNS records | MailDomain |
401 | Key missing or invalid | Error |
403 | api_key_permission_insufficient | |
409 | domain_already_exists | |
422 | Invalid parameters | Error |
503 | mail_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"})