Sign in
Email Domains

Import an already-provisioned email domain from the provider

Use this endpoint when the domain identity was created directly in the email provider's console or API. Temps will fetch its current verification state rather than registering a new identity, preventing duplicate or conflicting provider-side entries.

post/email-domains/import

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/email-domains/import
  • Auth: HTTP bearer

Request body

domainstring required

Domain name (e.g., "updates.example.com")

provider_idinteger required

Provider ID to import the domain into

provider_identity_idstring nullable

Provider-internal identity identifier. Required for Scaleway (the domain UUID shown in the Scaleway console); ignored/optional for SES.

Example request

{
  "domain": "updates.example.com",
  "provider_identity_id": "12345678-1234-1234-1234-123456789012"
}

Response

Domain imported successfully

Example response

{
  "dns_records": [
    {
      "name": "temps._domainkey.example.com",
      "record_type": "TXT",
      "value": "v=DKIM1; k=rsa; p=MIGfMA0GCSqGSIb3..."
    }
  ],
  "domain": {
    "created_at": "2025-12-03T10:30:00Z",
    "domain": "updates.example.com",
    "status": "verified",
    "updated_at": "2025-12-03T10:30:00Z"
  }
}

Changes

No recorded changes to this operation across all 50 revisions of this API.