Skip to main content

Create User (SCIM)

Create a new user using SCIM 2.0 protocol.

Endpoint​

POST /scim/v2/Users

Headers​

HeaderRequiredDescription
AuthorizationYesBearer <scim_bearer_token>
Content-TypeYesapplication/scim+json
AcceptYesapplication/scim+json or application/json

Request Body​

{
  "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],
  "userName": "user@example.com",
  "name": {
    "formatted": "John Doe",
    "familyName": "Doe",
    "givenName": "John"
  },
  "active": true,
  "emails": [
    {
      "value": "user@example.com",
      "primary": true
    }
  ]
}

Response​

Success (201)​

{
  "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],
  "id": "123",
  "userName": "user@example.com",
  "name": {
    "formatted": "John Doe",
    "familyName": "Doe",
    "givenName": "John"
  },
  "active": true,
  "emails": [
    {
      "value": "user@example.com",
      "primary": true
    }
  ],
  "meta": {
    "resourceType": "User",
    "created": "2024-01-01T12:00:00Z",
    "lastModified": "2024-01-01T12:00:00Z",
    "location": "/scim/v2/Users/123"
  }
}

Error (400)​

{
  "schemas": ["urn:ietf:params:scim:api:messages:2.0:Error"],
  "detail": "Request must include schemas with urn:ietf:params:scim:schemas:core:2.0:User",
  "status": "400",
  "scimType": "invalidSyntax"
}

Features​

  • SCIM 2.0 compliant
  • Creates user in the organization associated with the bearer token
  • Auto-generates user ID
  • Returns created user with location header

Example​

curl -X POST "https://api.rivergen.com/scim/v2/Users" \
  -H "Authorization: Bearer <scim_bearer_token>" \
  -H "Content-Type: application/scim+json" \
  -H "Accept: application/scim+json" \
  -d '{
    "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],
    "userName": "user@example.com",
    "name": {
      "formatted": "John Doe",
      "familyName": "Doe",
      "givenName": "John"
    },
    "active": true,
    "emails": [{
      "value": "user@example.com",
      "primary": true
    }]
  }'