Galon Cloud
Galon API v1

/projects/{project_id}/mail/free

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

POST /projects/{project_id}/mail/free

Activate the Galon Mail free tier

Activates, without payment, the product chosen during onboarding. A tenant can combine Transactional Free and Marketing Free. Sending remains closed until DNS verification and activation of the production channel.

Console session only (signed-in console).

Parameters

NameInTypeDescription
project_idpathstring · required

Request body

application/json · schema MailCheckout

FieldTypeDescription
versioninteger · required
billing_countrystring
payment_method"card" | "mobile_money" | "carte"An identifier from `GET /billing/payment-methods` for this country; if absent: card. `carte` is still accepted as a legacy alias of `card`.
phonestringThe client's phone number, in international format ('+225 07 00 00 00 00', reduced to E.164), required when the card is charged through a subscription with a payment provider that requests it; if absent in that case: 422 `mail_checkout_phone_required`.

Responses

StatusDescriptionBody
200Existing free entitlement
201Free entitlement created
409Version or free project conflict
422Invalid parametersError
503Activation unavailable

Examples

curl

curl -X POST "$GALON_API_BASE/projects/<project_id>/mail/free" \
  -H "Authorization: Bearer $GALON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"version": 1}'