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
| Name | In | Type | Description |
|---|---|---|---|
project_id | path | string · required |
Request body
application/json · schema MailCheckout
| Field | Type | Description |
|---|---|---|
version | integer · required | |
billing_country | string | |
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`. |
phone | string | The 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
| Status | Description | Body |
|---|---|---|
200 | Existing free entitlement | |
201 | Free entitlement created | |
409 | Version or free project conflict | |
422 | Invalid parameters | Error |
503 | Activation 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}'