Galon Cloud
Galon API v1

/receiving-domains

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

GET /receiving-domains

List inbound domains

Key carrying mail:send AND job:read. Served only when inbound is open to the account (404 not_found otherwise).

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

Responses

StatusDescriptionBody
200Project's inbound domainsobject
401Key missing or invalidError

Examples

curl

curl -X GET "$GALON_API_BASE/receiving-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.receivingDomains.list({ limit: 20 });

Python (SDK)

from galon import Galon

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

POST /receiving-domains

Register an inbound domain

Key carrying mail:send AND job:read. Served only when inbound is open to the account (404 not_found otherwise). The domain must be a verified sending identity; the response gives the MX record to publish.

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

Request body

application/json

FieldTypeDescription
domainstring · required

Responses

StatusDescriptionBody
201Domain registered, MX to publishobject
409Already registeredError
422Domain not verified or invalidError
503inbound_region_unconfiguredError
401Key missing or invalidError

Examples

curl

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

Node.js (SDK)

import { Galon } from "galon";

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

Python (SDK)

from galon import Galon

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