POST User API
The POST User API creates a new user in the account.
How it works
Use the POST method to create a new user:
POST /scim/v2/Users/
Authentication
The SCIM 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 |
|---|---|---|---|
userName |
Object | Required | The username of the user in email address format. This must be a valid email address. |
emails |
Array | Optional | If this value does not match userName, the value is ignored. |
active |
Boolean | Optional | Indicates whether the user is active. |
name |
Object | Optional | A list that contains the user’s name. Each name can contain givenName and familyName. Null and empty values are allowed. |
Example cURL request
curl -X POST "https://api.tealiumiq.com/scim/v2/Users/" \
-H "Content-Type: application/scim+json" \
-H "Accept: application/scim+json" \
-d '{
"schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],
"userName": "new.user@example.com",
"name": {
"givenName": "New",
"familyName": "User"
},
"emails": [{
"value": "new.user@example.com"
}],
"active": true
}'
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, PUT, DELETE."} |
| 409 | {"schemas": ["urn:ietf:params:scim:api:messages:2.0:Error"],"status": "409","scimType": "uniqueness","detail": "User 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: October 20, 2025