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).
