SCIM and Genesys Cloud field mappings

Note: This article applies to Genesys Cloud SCIM (Identity Management).

This table shows the SCIM fields that Genesys Cloud SCIM (Identity Management) maps to Genesys Cloud fields. These SCIM fields are then mapped to fields in third-party applications. 

SCIM field Genesys Cloud field Notes
id UserProfile.Id
userName UserProfile.contactInfo.email_main.[0].value
state UserProfile.state true eq ‘active’ false eq ‘inactive’
displayName UserProfile.general.name.[0].value
title UserProfile.general.title.[0].value
scimEnterpriseUser.manager.value UserProfile.relationships.manager.[0].value Full URN: urn:ietf:params:scim:schemas:
extension:enterprise:2.0:
User:manager.value
scimEnterpriseUser.department UserProfile.general.department.[0].value Full URN: urn:ietf:params:scim:schemas:
extension:enterprise:2.0:
User:department
scimEnterpriseUser.division UserProfile.divisionId Full URN: urn:ietf:params:scim:schemas:
extension:enterprise:2.0:
User:division
emails[type eq "other"].value UserProfile.contactInfo.email_main.[0].value This field is the same as userName. This field is Read Only. 
emails[type eq "work"].value UserProfile.contactInfo.email_work.[0].value
phoneNumbers[type eq "work<"].value1 UserProfile.contactInfo.[0].phone_work.[0].value.number
phoneNumbers[type eq "work2"].value1 UserProfile.contactInfo.[0].phone_work_2.[0].value.number
phoneNumbers[type eq "work3"].value1 UserProfile.contactInfo.[0].phone_work_3.[0].value.number
phoneNumbers[type eq "work4"].value1 UserProfile.contactInfo.[0].phone_work_4.[0].value.number
phoneNumbers[type eq "home"].value1 UserProfile.contactInfo.[0].phone_home.[0].value.number
phoneNumbers[type eq "other"].value1 UserProfile.contactInfo.[0].phone_other.[0].value.number
phoneNumbers[type eq "mobile"].value1 UserProfile.contactInfo.[0].phone_mobile.[0].value.number
meta.location {UserProfile self URL}
meta.version (ETag) UserProfile.version
meta.lastModified UserProfile.dateModified
externalId {external ID API}
roles.[].value {user roles API}
name.givenName Not currently supported by Genesys Cloud.
name.familyName Not currently supported by Genesys Cloud.
addresses[type eq "work"].postalCode Not currently supported by Genesys Cloud.
addresses[type eq "other"].Formatted Not currently supported by Genesys Cloud.
addresses[type eq "work"].streetAddress Not currently supported by Genesys Cloud.
emails[type eq "{type}"].primary UserProfile.primaryContactInfo.email.[0].value.fieldPath This field is set to boolean constant "true" in vendor mapping.
phoneNumbers[type eq "{type}"].primary UserProfile.primaryContactInfo.voice.[0].value.fieldPath This field designates the phone number associated with the field as the primary phone number on the user’s contact information. This field is set to boolean constant "true" in vendor mapping.
groups UserProfile.groups[type eq official] + {groups where user is owner}
password User.profile Password cannot be returned but can be updated with PUT or PATCH. 
scimEnterpriseUser.employeeNumber UserProfile.hr.empId.[0].value Full URN: urn:ietf:params:scim:schemas:
extension:enterprise:2.0:
User:employeeNumber
scimUserExtensions.
routingSkills.[].name
{user routing skills API} Full URN: urn:ietf:params:scim:schemas:
extension:genesys:purecloud:2.0:
User:routingSkills.[].name
scimUserExtensions.
routingSkills.[].proficiency
{user routing skills API} Full URN: urn:ietf:params:scim:schemas:
extension:genesys:purecloud:2.0:
User:routingSkills.[].proficiency
scimUserExtensions.
routingLanguages.[].name
{user routing languages API} Full URN: urn:ietf:params:scim:schemas:
extension:genesys:purecloud:2.0:
User:routingLanguages.[].name
scimUserExtensions.
routingLanguages.[].proficiency
{user routing languages API} Full URN: urn:ietf:params:scim:schemas:
extension:genesys:purecloud:2.0:
User:routingLanguages.[].proficiency

For more information about mappings in Microsoft Entra ID, see Configure Microsoft Entra ID for Genesys Cloud SCIM (Identity Management).

For information about Genesys Cloud SCIM (Identity Management), see About Genesys Cloud SCIM (Identity Management) and Genesys Cloud SCIM (Identity Management) overview (Genesys Cloud Developer Center).