Domains

Live keys can only send from domains your organization has verified. Domains belong to the organization and are shared by all of its projects.

Adding a domainCopy Anchor Link

Add the domain in the dashboard (Domains) or through the API, then publish the DNS records it returns at your DNS provider:

const { data: domain, error } = await coss.domains.create({ name: "acme.com" });

for (const record of domain?.records ?? []) {
  console.log(record.type, record.name, record.value);
}

Copy the exact values from the dashboard or the records array: the DKIM tokens and region are specific to your domain.

VerificationCopy Anchor Link

COSS checks the records automatically; the dashboard and each record's status show the result of the last check, and can_send says whether live keys may send from the domain. Verification usually takes minutes, but DNS changes can take longer to propagate. If a domain is not verified within 72 hours, verification fails. Restarting it (Verify in the dashboard, or coss.domains.verify(id)) issues new DKIM records to publish.

When several organizations verify overlapping domains, the most specific one decides who may send: verifying mail.example.com lets you send from @mail.example.com even if someone else verified example.com.

Tracking domainCopy Anchor Link

A verified domain can serve open and click tracking links from its own subdomain, such as links.acme.com. See custom tracking domains.