Example SCIM requests

Get Hoxhunt's SCIM schema

 GET https://app.hoxhunt.com/services/scim/schemas
 Authorization: Bearer <your_scim_token> 

Get all users

 GET https://app.hoxhunt.com/services/scim/Users

Get a user

 GET https://app.hoxhunt.com/services/scim/Users/*HoxhuntUserIDHere*
 GET https://app.hoxhunt.com/services/scim/Users/?filter=userName eq "tony.iommi@hoxhunt.com"
GET https://app.hoxhunt.com/services/scim/Users/?filter=emails%5Btype%20eq%20%22work%22%5D.value%20 eq "tony.iommi@hoxhunt.com"

Create user

POST https://app.hoxhunt.com/services/scim/Users
Content-Type: application/scim+json
Authorization: Bearer YOUR_SCIM_TOKEN
{
  schemas: [
    'urn:ietf:params:scim:schemas:core:2.0:User',
    'urn:ietf:params:scim:schemas:extension:enterprise:2.0:User',
  ],
  userName: 'tony.iommi@hoxhunt.com',
  name: {
    familyName: 'Tony',
    givenName: 'Iommi',
  },
  emails: [
    {
      value: 'tony.iommi@hoxhunt.com',
      type: 'work',
      primary: true,
    },
  ],
  active: true,
  'urn:ietf:params:scim:schemas:extension:enterprise:2.0:User': {
    department: 'Metal shear',
    division: 'Sheet-metal factory',
  },
  addresses: [
    {
      country: 'England',
      type: 'work',
    },
  ],
}

Update user

PATCH https://app.hoxhunt.com/services/scim/Users/*HoxhuntUserIDHere*
Content-Type: application/scim+json
Authorization: Bearer YOUR_SCIM_TOKEN
{
  schemas: ['urn:ietf:params:scim:api:messages:2.0:PatchOp'],
  Operations: [
    {
      op: 'Replace',
      path: 'urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department',
      value: 'Sales',
    },
  ],
}

Deactivate/activate user

PATCH https://app.hoxhunt.com/services/scim/Users/*HoxhuntUserIDHere*
Content-Type: application/scim+json
Authorization: Bearer YOUR_SCIM_TOKEN
{
  schemas: ['urn:ietf:params:scim:api:messages:2.0:PatchOp'],
  Operations: [
    {
      op: 'Replace',
      path: 'active',
      value: true,
    },
  ],
}

Useful links

Was this article helpful?

3 out of 3 found this helpful

Have more questions? Submit a request