# Claim org domain

> Source: https://elaichi.ai/docs/api-reference/org-domains/org-domain/createorgdomain/

`POST /org-domain`

Resource: **Org Domain** · API: **Org domains**

## Request body

- **`domain`** _(string)_
  A valid DNS name, e.g. `acme.com`. Lowercased.

## Response body

- **`id`** _(string)_
  Org domain id.
- **`organization_id`** _(string)_
  Owning organization (`org_…`).
- **`domain`** _(string)_
  DNS name, lowercased (e.g. `acme.com`).
- **`verified`** _(boolean)_
- **`verification_record`** _(string,null)_
  The exact DNS TXT value to publish. Present until the domain is verified, then null — the token is of no further use.
- **`default_role_id`** _(string,null)_
  Role (`role_…`) explicitly configured for domain auto-join, or null to track the default. Org Owner is refused here. Read `effective_default_role_id` to learn what a join actually grants.
- **`effective_default_role_id`** _(string,null)_
  Server-computed: the role a verified-domain auto-join really grants. Equals `default_role_id` when that is set and the role still exists; otherwise the **Member** system role, which is what the join falls back to both when nothing is configured and when the configured role has since been deleted. `null` means even that fallback is missing, so auto-join on this domain fails rather than seating anyone.
- **`sso_connection_id`** _(string,null)_
  Linked SSO connection (`sso_…`).
- **`created_at`** _(string)_
- **`updated_at`** _(string)_

## Code examples

### curl

```bash
curl -X POST 'https://api.elaichi.ai/org-domain' \
  -H 'Authorization: Bearer $ELAICHI_API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"domain":"your_domain"}'
```

### JavaScript

```javascript
const body = {
  "domain": "your_domain"
};

const response = await fetch('https://api.elaichi.ai/org-domain', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ' + process.env.ELAICHI_API_TOKEN,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(body),
});

const data = await response.json();
console.log(data);
```

### Python

```python
import os
import requests

url = "https://api.elaichi.ai/org-domain"
headers = {
    "Authorization": f"Bearer {os.environ['ELAICHI_API_TOKEN']}",
    "Content-Type": "application/json",
}
payload = {
    "domain": "your_domain"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())
```