Create a user | Documentation

curl -X POST https://api.contentful.com/scim/v2/organizations/org_id/Users \
     -H "Content-Type: application/scim+json" \
     -d '{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User"
  ],
  "userName": "user@example.com",
  "name": {
    "givenName": "Kasia",
    "familyName": "Kowalska"
  }
}'

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User"
  ],
  "id": "1xGZIRXr2WPnsLkKfREo0z",
  "meta": {
    "resourceType": "User",
    "created": "2025-03-14T09:22:18Z",
    "lastModified": "2026-01-07T14:35:42Z",
    "location": "https://api.contentful.com/organizations/7BslKh9TdKGOK41VmLDjFZ/scim/v2/Users/1xGZIRXr2WPnsLkKfREo0z"
  },
  "userName": "user@example.com",
  "name": {
    "givenName": "Kasia",
    "familyName": "Kowalska"
  },
  "active": true,
  "emails": [
    {
      "value": "user@example.com",
      "type": "work",
      "primary": true
    }
  ]
}

Creates a user in the organization with the member role; new users appear as “Invited” until accepted. SSO-enabled organizations do not send invitation emails.

Path parameters

org_idstringRequired

Request

This endpoint expects a map from strings to any.

Response headers

Content-Typestring

Content-Type

Response

Created - Resource created successfully