Domains

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude

Domain verification lets you prove ownership of an email domain so you can create users directly within your tenant — without sending invitation emails. Once a domain is verified, any user with a matching email address can be created via the Create user endpoint.

How it works

1. Register your domain in Aritma IAM — you receive a DNS TXT verification token
2. Publish the token as a DNS TXT record at your domain registrar
3. Aritma checks for the record and marks the domain as Confirmed
4. You can now create users directly for email addresses on that domain

List verified domains

curl -i -X GET \
  'https://developer.aritma.com/_mock/apis/platform/iam/openapi/iam-openapi/v1/domains?filter=string' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Register a domain for verification

curl -i -X POST \
  'https://developer.aritma.com/_mock/apis/platform/iam/openapi/iam-openapi/v1/domains?domain=string' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

The response includes a verificationToken — a DNS TXT record value you must publish at your domain registrar:

{
  "domain": "example.com",
  "status": "Pending",
  "verificationToken": "aritma-verify-00000000-0000-0000-0000-000000000000"
}

Add a TXT record to your DNS with the value of verificationToken. The record name is typically @ (root) or a subdomain specified by your registrar.

Check domain status

Poll this endpoint to check whether verification has completed:

curl -i -X GET \
  'https://developer.aritma.com/_mock/apis/platform/iam/openapi/iam-openapi/v1/domains/status?domain=string' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Unregister a domain

curl -i -X DELETE \
  'https://developer.aritma.com/_mock/apis/platform/iam/openapi/iam-openapi/v1/domains?domain=string' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'