POST Group API
The POST Group API creates a new group in the account.
How it works
Use the POST method to create a new group:
POST /scim/v2/Groups/
Authentication
The OAuth bearer token is used to authenticate all API calls, not the API key.
For more information, see Authentication.
POST operation parameters
This command takes the following parameters:
| Object | Type | Required | Description |
|---|---|---|---|
displayName |
String | Required | The name of the group. |
members |
Array | Optional | A list of members in the group. Each member can contain value, type, display, and $ref. |
Example cURL request
curl -X POST "https://developer.tealiumapis.com/scim/v2/Groups/" \
-H "Content-Type: application/scim+json" \
-H "Accept: application/scim+json" \
-d '{
"schemas": [
"urn:ietf:params:scim:schemas:core:2.0:Group"
],
"displayName": "Group 1",
"members": [
{
"value": "aa3b970c-b459-4843-9f95-853a49b65f87",
"type": "User",
"display": "user1@example.com",
"$ref": "/scim/v2/Users/aa3b970c-b459-4843-9f95-853a49b65f87"
},
{
"value": "aa3b970c-b459-4843-9f95-853a49b65f88",
"type": "User",
"display": "user2@example.com",
"$ref": "/scim/v2/Users/aa3b970c-b459-4843-9f95-853a49b65f88"
}
]
}'
Example response
Error messages
Potential error messages for this endpoint:
| Error code | Error message |
|---|---|
| 400 | {"schemas": ["urn:ietf:params:scim:api:messages:2.0:Error"],"status": "400","scimType": "invalidValue","detail": "User payload is required." |
| 401 | {"returnCode" : 1401 , "message" : "Authentication failed."} |
| 403 | {"schemas": [ "urn:ietf:params:scim:api:messages:2.0:Error"],"status": "403","scimType": null,"detail": "Missing X-Tealium-Account header."} |
| 405 | {"schemas": ["urn:ietf:params:scim:api:messages:2.0:Error"],"status": "405","scimType": "invalidMethod","detail": "Method is not allowed on this endpoint. Allowed methods: GET, POST."} |
| 409 | {"schemas": ["urn:ietf:params:scim:api:messages:2.0:Error"],"status": "409","scimType": "uniqueness","detail": "Group name 'group 1' already exists in the given account."} |
| 500 | {"schemas": ["urn:ietf:params:scim:api:messages:2.0:Error"],"status": "500","scimType": "internalServerError","detail": "Error processing json for extension - account {ACCOUNT}"} |
This page was last updated: December 17, 2025