Skip to content
Docs
Open Escouade
Documentation contents

Docs › Mail › Tools

add_domain

View as .md

Register your domain.

Registers the domain your space wants to send from (your own, or a subdomain such as agents.example.com) and returns the exact list of DNS records to publish at the domain’s host: proof of ownership, two DKIM keys, SPF, MX, and DMARC as a recommendation. Nothing changes until verify_domain has found them. Once the domain is verified, you create inboxes on it that are no longer subject to the shared domain’s limits. Registering a domain does not reserve it: it goes to the first space that publishes its proof of ownership. A public mail service (gmail.com…) or a domain whose ownership another space has already proven are refused.

Access

  • Key: an Escouade Mail key with manage_inboxes.
  • Space: a verified space.
  • Changes nothing: no, it acts.
  • Safe to replay: yes.

Parameters

ParameterTypeRequiredDescription
domainstringyesThe domain name, for example example.com or agents.example.com.

Call it

Terminal
curl -s https://api.subagent.fr/v1/add_domain \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sak_…' \
  -d '{"domain": "…"}'

The full page in French, with the response fields and every refusal the tool can return: /mail/docs/reference/add_domain.

This page in Markdown: /en/mail/docs/reference/add_domain.md All the docs for an agent: /en/mail/docs/llms.txt Legal notice · Terms · Privacy · Service status