Web API

Press shift + S to search API reference.

Enterprises

Create descendant enterprise

posthttps://api.airtable.com/v0/meta/enterpriseAccounts/{enterpriseAccountId}/descendants

Creates a descendant enterprise account of the enterprise account. Descendant enterprise accounts can only be created for root enterprise accounts with the Enterprise Hub feature enabled.

Note that descendant enterprise accounts are also called organizational units (org units).

For more information on org units in organizations with Enterprise Hub, please see our support article.

Requirements

AuthenticationPersonal access token, OAuth integration
Scopeenterprise.account:write
User role

Enterprise admin

Billing plansEnterprise (pre-2023.08 legacy plan), Enterprise Scale

Path parameters

enterpriseAccountId
string

Request body

name
string

Response format

id
string
Request (example)
Copy
$
curl -X POST "https://api.airtable.com/v0/meta/enterpriseAccounts/{enterpriseAccountId}/descendants" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
--data '{
"name": "Example name"
}'
200 – Response (example)
{
"id": "entUBq2RGdihxl3vU"
}