In addition to required mappings needed for SCIM to function, Productive also supports optional attribute mappings.
These can help you sync additional user details such as manager, user type, company, workplace, or even employee fields.
👉 Not sure how to set up SCIM to begin with? Start with our initial SCIM setup guide here.
How to Add Optional Attribute Mappings in Entra
To configure any optional mapping:
Go to your Productive SCIM application in Microsoft Entra.
Open Provisioning > Mappings > Provision Microsoft Entra ID Users.
Click Add new mapping.
Fill out the fields as described below (details vary slightly for each mapping).
General Field Guidelines
Mapping type: Keep as Direct, unless noted otherwise.
Source attribute: The attribute from Entra you're mapping from.
Target attribute: The SCIM attribute in Productive you're mapping to.
Default value if null: Leave this blank.
Match object using this attribute / Matching precedence / Apply this mapping: Leave as is.
📌 Click Save after each mapping is created.
Manager Sync
Use this mapping to assign a manager to a provisioned user in Productive.
Source attribute:
managerTarget attribute:
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager
📌 The manager must also be assigned to the Productive SCIM application in Entra to be synced.
Differentiating Employees and Contractors
To provision different user types (Employees vs. Contractors), configure both user type and company mappings.
1. User Type Mapping
Target attribute:
userType
Supported values in Productive:
employeecontractor
These values aren't usually stored in Entra, so you will have to use Entra’s Expression Builder to map your values to Productive's supported values. To use the Expression Builder in Entra:
Change Mapping type to Expression
Use an expression like this:
IIF([employeeType]="External", "contractor", IIF([employeeType]="Internal", "employee", [employeeType]))
☎️ Need help with expressions? Contact our support team for assistance.
2. Company Mapping (Mandatory For Contractors)
This mapping links contractors to their company in Productive.
Source attribute:
companyNameTarget attribute:
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization
📌 If the company name doesn't exist in Productive, a new company will be created automatically.
Workplace Sync (Subsidiaries)
Use this mapping to assign users to a specific workplace (or subsidiary) in Productive.
Source attribute:
physicalDeliveryOfficeName
(or another attribute that stores the office/workplace name)Target attribute:
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division
📌 If workplace names in Entra don’t match those in Productive, use the Expression Builder to remap them.
📌 If the workplace name doesn’t exist in Productive, the user will not be provisioned.
Syncing Custom Fields from Entra
Step 1: Copy SCIM Attribute from Productive
Go to Settings > Employee Fields in Productive.
Click the three dots next to a custom field.
Select Copy SCIM attribute.
Step 2: Add the Attribute in Entra
In Entra, go to the User attribute mappings screen.
Click Show advanced options, then Edit attribute list for [name].
Scroll to the bottom, paste the copied attribute from Productive.
Keep the type as String and click Save.
Step 3: Map the Attribute
Add a new mapping.
Source attribute: Any Entra field you want to sync.
Target attribute: The new SCIM attribute you just added (it will look something like this:
urn:ietf:params:scim:schemas:extension:customfields:2.0:User:cf45)
📌 The number at the end (cf45) will differ based on your custom field!
Next Steps
With optional mappings configured, your SCIM provisioning becomes more powerful and in line with your team structure in Productive.
These mappings help ensure that managers, contractors, companies, and custom data are set up accurately without any manual input.
For details on initial SCIM configuration, visit the main SCIM setup article.