Skip to main content

Custom Attribute Mapping

Fairjungle supports custom SCIM user attribute mappings, allowing you to control how incoming SCIM data is interpreted and stored in Fairjungle.

With SCIM User Mappings, you can map an incoming SCIM attribute to either:

  • A standard Fairjungle user attribute (e.g., email, phone number)
  • A custom user field defined in your Fairjungle environment

This enables flexible integrations between your Identity Provider (IdP) and Fairjungle, so that SCIM data is saved exactly where you want it.


πŸ”§ Managing Mappings​

At the moment, SCIM user mappings can only be configured via the Fairjungle API. There is no configuration interface in the admin dashboard yet.


Supported SCIM Attributes​

The list of SCIM attributes that you can map from includes those defined in:

These attributes include fields like userName, name.givenName, emails, phoneNumbers, employeeNumber, and more.


Supported Fairjungle Attributes​

You can map SCIM attributes to the following standard Fairjungle user fields:

Fairjungle AttributeDescription
dateOfBirthUser’s date of birth
emailPrimary email address
firstNameFirst name
lastNameLast name
phoneNumberPhone number

In addition to these standard attributes, you can also map SCIM attributes to custom fields created in your Fairjungle account.

πŸ’‘ Custom fields are useful for handling company-specific data, such as costCenter, travelPolicy, or employeeType.


Example Use Case​

Let’s say your SCIM data includes an attribute like employeeNumber. You can map it to a custom Fairjungle field called employeeId using the API. From that point on, any time a user is provisioned or updated via SCIM, their employeeNumber will be saved in the employeeId field in Fairjungle.


Need Help?​

If you're unsure how to define mappings or use the API, reach out to Fairjungle Support or refer to the API documentation for examples and request formats.