This article applies specifically to organizations using the HRIS Sync integration.
When you connect your HRIS as a Directory source through the HRIS Sync tile, ContactMonkey syncs your standard employee fields automatically. If you want to bring in custom data from your HRIS that your team has set up, you can map it to a new field in your Directory.
You can map custom fields at two points:
- Connecting your HRIS for the first time? Follow Connect Your HRIS and Add Custom Fields to do both in one flow.
- Already syncing from your HRIS? Jump to Add Custom Fields to an Existing HRIS Sync.
Before You Begin
- You need admin access in your HRIS to connect it. If you're not an admin, you can copy the link shown in the connection window and send it to your HRIS admin so they can finish the setup.
- To connect for the first time, have your HRIS credentials ready. The connection window tells you exactly what's needed for your HRIS. For example, UKG Pro asks for a Customer API Key, a service account username and password, and a web services URL.
Connect Your HRIS and Add Custom Fields
Use these steps if your HRIS isn't connected to ContactMonkey yet.
🎥 Video Walkthrough (Shown with UKG Pro)
Connect Your HRIS
- Click Directory at the top of the ContactMonkey dashboard
- Click Sources
- Under Inactive Sources, find HRIS Sync tile and click Configure
- If asked to confirm your role, click I am an admin, then click Next
- Enter the credentials your HRIS asks for, clicking Next after each screen. Follow the guidelines outlined in your HRIS' help article, which can be found in the HRIS Sync folder.
Map Your Custom Fields
Once your HRIS is connected, the Map additional fields screen opens. Standard fields are already included, so you only need to map the extra fields you want.
- Click Map fields
- Click Mapping to add a new field pair
- Under Your [HRIS] fields, click Select or start typing and choose the field you want to bring in (for example, Employee_ShirtSize)
- Under New target field, click Enter field name and type a name for the field as it should appear in ContactMonkey (for example, Shirt Size)
- Click Add
- Repeat steps 2–5 for any other fields you want to map
- Click Save to apply your field mappings
Don't need any custom fields right now? Click Skip for now on the Map additional fields screen. You can add them later using the steps below.
Add Custom Fields to an Existing HRIS Sync
Use these steps if your HRIS is already syncing to your Directory.
🎥 Video Walkthrough
- Click Directory at the top of the ContactMonkey dashboard
- Click Sources
- Under Active sources, find the tile for your HRIS and click Manage
- Click Map additional fields
- Click Map fields
- Click Mapping to add a new field pair
- Under Your [HRIS] fields, click Select or start typing and choose the field you want to bring in (for example, Employee_ShirtSize)
- Under New target field, click Enter field name and type a name for the field as it should appear in ContactMonkey (for example, Shirt Size)
- Click Add
- Repeat steps 5–8 for any other fields you want to map
- Click Save, then click Finish setup
Newly added fields will be immediately synced into ContactMonkey. This can take a few minutes.