Who can use this feature?
Available on:
All Culture Amp subscriptions.
You can import employee data directly from Justworks into Culture Amp using a secure, one-way API connection. This ensures your employee list and demographics are always up-to-date.
Data Flow: Employee Data flows from Justworks into Culture Amp (one-way sync). Changes made in Culture Amp will not sync back to your HRIS.
Choosing Your Integration Method
We offer two primary ways to connect your employee data. For Justworks, the API integration is the standard, recommended approach. The table below briefly outlines both options to help with decision-making:
Method | Type of Import | Best For | Key Difference |
Full Integration (API) | Full Employee Import | Organizations seeking real-time, daily automation of all employee data that the API supports. | Data transfer is handled automatically via a secure API connection (e.g., using Merge). Users left off the file with a termination date (End Date) will become former employees upon sync. For users who simply fall off the data without a termination date, they will remain Active in Culture Amp until a manual sync is triggered by Culture Amp Support. We strongly recommend ensuring all terminated employees have an end_date in the HRIS to guarantee accurate deactivation. |
SFTP (Secure File Transfer Protocol) | Partial Employee Import | Organizations that need complete control over file creation, have unique filtering requirements, or need to manage data fields not supported by the API. | You generate a file and securely transfer it to us at scheduled intervals. Users missing from the file are ignored unless you include an |
API Integration Checklist (step-by-step)
Use this checklist to navigate the API integration setup. Each step links to a more detailed section below.
Access Requirements & Terminology — Prerequisites and system logic.
Step 1: Connect & Authenticate — Locating and entering your API credentials.
Step 2: Field Mapping — Review the automated field mapping logic.
Step 3: Activate Integration — Establishing the technical connection.
Step 4: Run Your First Sync — Reviewing and importing employee records.
Troubleshooting & FAQs — Solving errors, duplicates, and sync blocks.
Before You Start: Access Requirements & Terminology
To set up the connection, you’ll need:
Access to your Justworks instance with permissions to read employee data (usually an administrator or similar role with full access).
Access to Culture Amp with Account Administrator or Employee data administrator permissions
Important Considerations & Data Limitations
Important Considerations & Data Limitations
Initial Setup Timeframe: The setup process is generally straightforward and relatively quick. However, involving an administrator familiar with your Justworks instance is always recommended to ensure you have the correct account access and can troubleshoot any permission-related issues quickly.
Field Mapping Limitation: Justworks currently does not support field mapping for custom demographics directly within the Culture Amp platform. This includes the ability to set up an exclusion field. Only the demographic fields listed in the table will automatically map. See the field mapping section for more details.
Terminology Breakdown
Terminology Breakdown
When working with your Justworks administrator, these terms may be helpful for clarifying your data structure:
Term | Also Known As | Definition & Example |
Object | Data Container, Entity | The primary record where the data lives (e.g., the employee's Member record). |
Field | Data Element, Attribute | The specific piece of data you are tracking (e.g., "Job Title," "preferred_name"). |
Value | Data Point | The specific data assigned to the employee for that Field (e.g., "Sales Representative"). |
Required Permissions & Rationales
Required Permissions & Rationales
Having the correct Justworks permissions is essential. Most setup and field-mapping issues occur when the connecting API user does not have access to the right objects.
Permission/Role | Permissions Needed in SAP SuccessFactors | Rationale |
Employee Data | API user must have read access to this object: Members | This is the specific API object (endpoint) the integration pulls data from to retrieve core employee and contact details. |
Required Roles | Justworks Administrator role or equivalent role with API read/write permissions. | Required to generate the necessary credentials (Client ID and Secret). |
Step 1: Connect and Authorize Your Justworks Account
The Justworks integration setup is initiated within the Culture Amp platform, which will redirect you to Justworks for authorization.
Sign in to Culture Amp with an account that has Account Administrator or Employee data administrator access.
Navigate to your Settings > Account > Integrations page in the Culture Amp platform.
Select Justworks from the list of integrations and click Continue setup.
Click I am an admin to confirm your Justworks administrator permissions.
You will see Culture Amp’s request to read your Justworks employee data. Click Next.
Open the window and login to Justworks to authorize the integration.
🔑 Authenticate Your Justworks Account
🔑 Authenticate Your Justworks Account
Overview
To authenticate your Justworks account, you will need to login to Justworks and authorize the integration in the linking flow.
Note: The steps below are sourced from Merge, our integration partner. We recommend checking their official guide for the most current instructions: Merge Justworks Account Linking Guide.
Prerequisites
Please ensure you fulfill all the requirements to set up the integration:
You are an Administrator in your company's Justworks instance, or someone has shared their access with you.
Your company is on an active paid plan with Justworks
Instructions
Step 1: Open window to the Justworks login screen
Step 2: Log into Justworks
Step 3: Click next on first screen
Step 4: Click on checkbox if applicable and click Authorize
The checkbox is only relevant if the company you're connecting to requires access to Sex or Date of Birth information. If they do not, you will not see this checkbox.
Fields Culture Amp has Read Access to
Employees
Employees
Date Of Birth
Display Full Name
Employee Number
Employment Status
First Name
Gender
Groups
Last Name
Manager
Mobile Phone Number
Personal Email
Preferred Name
Remote Created Timestamp
Start Date
Termination Date
Work Email
Groups
Groups
Name
Type
Step 2: Reviewing Field Mapping
The fields listed below are configured to automatically map to their equivalent in Justworks.
Note: While the underlying Merge API platform does have the technical capacity to support custom field mapping for many HRIS systems, the Culture Amp/Justworks integration is currently configured to only pull the demographics listed in this table. This simplifies setup, but means you cannot map custom demographics at this time. If you require additional demographic data, we recommend using an SFTP or Manual File Import.
Typical Justworks Source Field (API Name) | Justworks Endpoint (Data Location) | Culture Amp Field (The Destination) |
Pulled from the emails field. Crucial for matching. Must match the primary email in Culture Amp. |
| Email (Unique Identifier) |
Directly mapped from the Justworks API field |
| Employee ID (Unique Identifier) |
Pulled from |
| Name |
Directly mapped from the Justworks API field |
| Preferred Name |
Directly mapped from the Justworks API field |
| Date of Birth |
Directly mapped from the Justworks API field Corresponds to the employee's hire date. |
| Start Date |
Directly mapped from the Justworks API field |
| End Date |
Pulled from the |
| Manager Email / Manager ID / Manager Name |
Custom Demographics
Custom Demographics
Justworks currently does not support field mapping for custom demographics. Only the fields listed above will sync, so you will need to manage other demographics through manual imports.
Excluding Employees
Excluding Employees
Justworks does not support an exclusion field via the API. If you need to exclude users from your sync, you must use Culture Amp’s bulk deactivation feature as a workaround.
Allow the initial sync to import all users from Justworks, including those you want to exclude.
In Culture Amp, export a copy of your user list:
Go to Settings > Employee Data > Users > Import & Export > Export
Check the box for Include deactivated users
The export will contain a column labeled Employee Deactivated.
Update the
Employee Deactivatedcolumn in the exported file:Assign
"TRUE"to all users you want to exclude (they will be deactivated).Assign
"FALSE"to users who should remain active.
Save the file and perform a manual partial import:
Go to Settings > Employee Data > Users > Import & Export > Import users > Upload your file > Partial import.
Once complete, deactivated users will remain deactivated and will not be reactivated in future syncs.
Step 3: Activate Integration
Once everything's set up, you'll see the integration screen. Click Sync and the system will run an initial sync to connect your Justworks account details and mappings.
Note: This sync does not import employee data yet.
You will see a "Syncing data" message. This initial sync can take up to 12 hours to complete, depending on the size and complexity of your Justworks configuration.
Feel free to navigate away from the page. The process runs in the background.
The "Syncing data" message confirms the connection and mapping setup. Once this first sync completes, you can proceed to import your employee data through another sync.
Note: As part of our commitment to data security, only data relevant to your import and field mappings will be stored.
Step 4: Run Your First Employee Data Sync
Once the initial setup sync is complete, the Integrations page in Culture Amp will update. Follow these steps to run your first employee data import:
Click the Finalise sync button.
Click Get Started.
On the review page, ensure Sync is selected in the "Sync with merge" section (ignore the other options).
Culture Amp will validate the data. If there are no concerns, click Next.
Review the data: Carefully examine the review screen, which shows the number of new employees to be created, existing employees to be updated, and employees to be deactivated.
If the data looks correct, click Import Data to pull the employees into Culture Amp.
After the import is complete, click Go to Users to review the new users.
Important: If you see any unexpected numbers (e.g., too many employees being deactivated or created), do not proceed with the import. Check the Troubleshooting section or reply with "Ask a Person" in a Support Conversation to speak with a Product Support Specialist.
Once these steps are completed, you will see the green "Syncing data" notification appear on the Integrations page.
After syncing is complete, you will see the latest sync information, including the date and time of the last sync, and confirmation that your integration is Connected on the Integrations page.
Set Up Automated Daily Syncs
Set Up Automated Daily Syncs
By default, auto-syncs are Off. We recommend enabling daily syncing to ensure your employee demographics are kept up-to-date.
To enable: Go to Integrations, click on the Off button and toggle Auto-sync On.
To disable: Go to Integrations, click on the On button, then click Turn off auto sync.
Important:
Auto-sync won’t run if the Finalise sync step is still displayed. Click Finalise sync to finish setup.
While you can enable daily auto-sync, due to the current integration logic for Justworks, updates aren't always instant, but they are guaranteed. See the Troubleshooting/FAQs section to learn more.
Troubleshooting & FAQs
If the fixes below don't resolve your issue, please reply with "Ask a Person" in a Support Conversation to speak with a Product Support Specialist.
General Data Integrity & Import Management
The first step when investigating any data issue is to check the Import Summary Screen for your most recent import.
Go to Settings > Employee Data > Import History.
Select your most recent import to view details.
This screen provides information on the state of your integration, any specific errors, or will prompt you to run a manual sync to identify problems.
Justworks: Integration-Specific Errors
Justworks: Integration-Specific Errors
Issue | Cause | Suggested Fix |
Missing Data/Users | The connecting Justworks service account lacks the required read access to necessary employee data objects. | Verify Permissions: Ensure the user has full permissions to read all necessary employee data in your Justworks instance. |
Custom Demographics Not Syncing | Justworks API currently does not support custom field mapping via the Merge integration. | Alternative: If you require additional demographic data, you will need to manage these fields via a Manual File Import (CSV) or SFTP. |
Switching From CSV or Other Imports
Switching From CSV or Other Imports
If you are moving from CSV uploads or a different integration, keep the following in mind:
Demographic Consistency: When mapping fields, you must map the data to the exact same demographic field you used historically (e.g., mapping to "TEAM" is different from mapping to "TEAM NAME"). Using an incorrect or slightly different title risks discontinuity in your trended survey results.
Recommended Action: To avoid confusion, we recommend navigating to Settings > Employee Data Demographics and deleting the old, unused demographics after your first successful sync. (This won't impact any previous survey results.)
Handling Duplicate Employees
Handling Duplicate Employees
Culture Amp matches employees based on their Email address. If an employee has a different email in Culture Amp than in Justworks, duplicate profiles will be created.
Scenario | Action to Take |
A. Before Changes Are Applied | During the first sync review screen, stop the sync. Update the employee emails in Culture Amp to match those in Justworks.
|
B. After Changes Are Applied | To clean up the duplicated profiles:
|
Further Guidance | Check out our dedicated support guide for further information on duplicate employee clean-up. |
Sync Blocked to Protect Employee Privacy
Sync Blocked to Protect Employee Privacy
Your automated daily sync might be blocked if Culture Amp detects a high-risk change for an employee. You will receive an email notification if this occurs.
When It Happens: The sync is blocked if a combination of an employee's Name, Date of Birth, or Email is changed simultaneously.
Purpose: This prevents one employee from accidentally getting access to another employee's private information (like performance reviews).
Fix: If you've intentionally changed the employee's details, you can run a manual sync to push the change through. Go to Settings > Employee Data > Users, click Import data, and select Sync. Culture Amp will guide you through the rest.
Redaction of Sensitive Data
Redaction of Sensitive Data
As part of this integration, Culture Amp has the ability to redact sensitive data at your request. If you need any fields to be disabled/redacted for your account, please reply with "Ask a Person" in a Support Conversation to speak with a Product Support Specialist.
💬 Need help? Just reply with "Ask a Person" in a Support Conversation to speak with a Product Support Specialist.