Skip to content

Wildcard Domains & DNS Setup

EmBoux supports wildcard domains — configure DNS once for your parent domain, and every subdomain you create will work automatically without additional DNS changes.

Use wildcard if you plan to create subdomains under a single parent domain. For example:

  • ganemo.com (parent, wildcard)
  • client1.ganemo.com (subdomain — inherits DKIM from the parent)
  • client2.ganemo.com (subdomain — inherits DKIM from the parent)

When creating a domain via the API or portal, mark it as wildcard:

Terminal window
curl -X POST https://api.emboux.com/domains/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "ganemo.com"}'

Then set it as wildcard (master token only):

Terminal window
curl -X PUT https://api.emboux.com/domains/ganemo.com/parent \
-H "Authorization: Bearer YOUR_MASTER_KEY" \
-H "Content-Type: application/json" \
-d '{"is_wildcard": true}'

In the Odoo portal, simply check “I will create subdomains (wildcard)” when adding the domain.

For wildcard domains, use * entries so all subdomains are covered:

TypeNameValue
MX*.ganemo.commx1.emboux.com (Priority: 10)
TXT*.ganemo.comv=spf1 include:mailgun.org ~all
TXT_dmarc.ganemo.comv=DMARC1; p=quarantine; rua=mailto:[email protected]

The DMARC record lives at _dmarc.<parent> (here _dmarc.ganemo.com). Subdomains are covered by the parent’s policy.

Verify the parent domain once with POST /domains/ganemo.com/verify. The response lists the records to publish at your DNS provider:

TypeNameValue
TXTganemo.comSPF, for example v=spf1 include:mailgun.org ~all
TXT<selector>._domainkey.ganemo.comDKIM public key, exactly as returned by /verify
CNAMEemail.ganemo.commailgun.org

Use the exact values returned by /verify. Subdomains need no outbound DNS records of their own.

Use the DNS check endpoint to verify your records are configured correctly:

Terminal window
curl https://api.emboux.com/domains/ganemo.com/dns-check \
-H "Authorization: Bearer YOUR_API_KEY"

Response:

{
"name": "ganemo.com",
"all_ok": true,
"records": [
{"record_type": "MX", "name": "ganemo.com", "expected": "mx1.emboux.com", "status": "ok"},
{"record_type": "TXT", "name": "ganemo.com", "expected": "include:emboux.com", "status": "ok"},
{"record_type": "TXT", "name": "krs._domainkey.ganemo.com", "expected": "k=rsa; p=MIIBIjAN...", "status": "ok"},
{"record_type": "CNAME", "name": "email.ganemo.com", "expected": "mailgun.org", "status": "ok"}
]
}

Each record shows ok, missing, or incorrect.

In the portal, use the “Verify my DNS” button for a visual checklist.

Once the parent is verified, create subdomains — they inherit DKIM from the parent automatically:

Terminal window
curl -X POST https://api.emboux.com/domains/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "client1.ganemo.com"}'

The API auto-detects that client1.ganemo.com is a subdomain of ganemo.com and:

  • Links it to the parent domain
  • Inherits outbound_tier and outbound_enforcement
  • Skips separate verification (DKIM is inherited from the parent)
  • No additional DNS configuration needed

EmBoux detects the root domain and verifies it with the mail provider (Mailgun). For example, creating client1.ganemo.com verifies ganemo.com, not client1.ganemo.com.

Subdomains inherit DKIM from the parent: mail from client1.ganemo.com is signed with d=ganemo.com. You publish the verification records once for the parent, regardless of how many subdomains you create. If the parent is already verified, new subdomains are marked as verified immediately, with no extra DNS and no waiting.

Verification is checked automatically. Once the parent is verified, outbound email is enabled for all domains under it. You can also check manually:

Terminal window
curl https://api.emboux.com/domains/ganemo.com/verify-status -H "Authorization: Bearer YOUR_API_KEY"

Suppose your Odoo uses a mailbox of a subdomain, such as [email protected], under a verified wildcard parent:

  • Odoo sends through mx1.emboux.com, authenticating with a mailbox of that subdomain.
  • The visible From address is an address of the subdomain ([email protected]).
  • Reply-To can stay your own address (for example [email protected]), so replies reach you.
  • Authentication comes from the parent: the message is DKIM-signed with the parent domain (d=ganemo.com) and the parent’s DMARC applies with relaxed alignment. SPF, DKIM and DMARC pass.
  • You do not need to change the DNS of your own, unrelated domain, and you should not edit its SPF for this: it is not used for these emails. A strict SPF (-all) edited by mistake can break the mail you send through other services.
  • The SPF of mx1.emboux.com is irrelevant for delivery: the email goes out to the internet through the sending provider, not from mx1.

If you instead want to send as your own root domain, see Send as your own domain.

EndpointMethodDescriptionAuth
/domains/{name}/parentPUTSet parent_domain / is_wildcardMaster
/domains/{name}/dns-checkGETVerify DNS recordsAny
/domains/{name}/verifyPOSTInitiate domain verificationMaster
/domains/{name}/verify-statusGETCheck verification statusAny
/domains/{name}/register-subdomainPOSTRegister subdomain with providerMaster