organizationDomains

Request an email domain

Records a pending claim on a domain for Vitable to verify. The claim grants nothing until then — it does not auto-join anyone and does not reserve the domain against another organization. Requesting a domain the organization already claims returns that claim unchanged rather than creating a second one.

post/v1/organization-domains

Request

  • Base URL: https://api.vitablehealth.com
  • URL: https://api.vitablehealth.com/v1/organization-domains
  • Auth: HTTP bearer

Headers

X-Vitable-Organizationstring

Organization to act as for this request (e.g. org_SGVsbG8gV29ybGQ). Optional when your credentials reach a single organization. Required when they reach several — omitting it then returns 400 organization_required. A malformed value returns 400 invalid_organization_header, and naming an organization you do not have access to returns 403 organization_access_denied.

Request body

domainstring required

Bare email domain to claim, without the local part — acme.com, not jane@acme.com. Matching is exact, so mail.acme.com is a separate claim.

Response

Changes

No recorded changes to this operation across all 1 revision of this API.