Web API

Press shift + S to search API reference.

SCIM

Create group

posthttps://airtable.com/scim/v2/Groups

Create a new group from a SCIM Group object.

This endpoint creates a group with no members. Use the patch group or put group endpoints to populate the new group with members.

Requirements

AuthenticationPersonal access token, OAuth integration
Scopeenterprise.scim.usersAndGroups:manage
User role

Enterprise admin

Admins of multiple enterprises should use a service account's token when calling this route.
Billing plansEnterprise (pre-2023.08 legacy plan), Enterprise Scale

Request body

schemas
array of strings

A list of schemas, including at least SCIM's core group schema URI.

displayName
string | null

Becomes the displayName of the group in Airtable. It must not be in use already.

Response format

id
string

A user group ID

schemas
array of strings

A list of schemas, including at least SCIM's core group schema URI.

displayName
string | null

Becomes the displayName of the group in Airtable. It must not be in use already.

Request (example)
Copy
$
curl -X POST "https://airtable.com/scim/v2/Groups" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
--data '{
"displayName": "ExampleGroup",
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:Group"
]
}'
200 – Response (example)
{
"displayName": "ExampleGroup",
"id": "ugpEOS67LautSwEKM",
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:Group"
]
}