Web API

Press shift + S to search API reference.

SCIM

Put group

puthttps://airtable.com/scim/v2/Groups/{groupId}

Replace a Groups's attributes with all new values.

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

Path parameters

groupId
string

Request body

schemas
array of strings

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

displayName
optional<string | null>

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

members
optional<array of the below object>

List of members of the group.

value
string

Represents the user ID of a group member

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.

members
optional<array of the below object>

List of members of the group.

value
string

Represents the user ID of a group member

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