The Deel Local Payroll Push integration is designed for users who use Deel HR as their primary HRIS but continue to run local payroll within Deel Local Payroll.
Supported capabilities
- Automated Provisioning of new employee records in Deel Local Payroll once they are onboarded in Deel.
- Updates to existing employee profiles (e.g., address changes, job titles, or salary adjustments) in Deel are pushed to Deel Local Payroll in real-time.
- Once a pay run is finalized in Deel Local Payroll, you can trigger a sync. This allows the digital payslips to be retrieved and attached to the employee's profile in Deel for easy access.
- A dedicated Event Log in Deel allows admins to see exactly why a sync might have failed (e.g., a missing mandatory field required by Deel Local Payroll).
Supported worker types
- Direct Employees
Supported fields
- Employee Number (Worker ID)
- First Name
- Last Name
- Title (Mrs, Mss, Mr - default to Mr)
- Birthday
- Initials (Default to first and last name initials)
- Cell Number
- Gender (default to: Male)
- Race (default to: Other)
- Nationality (only first nationality)
- Effective Date (Contract start date - primary contract only)
- Pay Currency
- Pay Rate
- Pay Frequency
- Work Schedule (default to: Monday to Friday)
- Work Email
Field Mapping
Below is a list of fields used in Deel and what fields they are mapped to in Deel Local Payroll.
| Category | Deel Source Field | Deel Local Payroll Target Field | Logic / Notes |
| Worker Data | Worker ID | EmployeeNumber | |
| First Name | FirstName | ||
| Last Name | LastName | ||
| Birth Date | Birthday | ||
| Full Name initials | Initials | ||
| Work Email | |||
| Nationalities | Nationality | ||
| Employment Start Date | EffectiveDate | ||
| Address | (N/A) | AddressType | Hardcoded to Physical |
| Street Address | AddressLine1 | ||
| City | AddressLine3 | ||
| Postal Code | AddressCode | ||
| Region/Province | AddressCountry | Validates against Deel Local Payroll; defaults to first valid value | |
| Personal Data | Demographics gender | Gender | Defaults to Male |
| (Gender-based) | Title | Male → "Mr", Female → "Ms", Default → "Mr" | |
| Personal phone | CellNumber | ||
| Employment | Payment scale/cycle | PayFrequency | Mapped to Deel Local Payroll Frequency |
| (N/A) | HoursPerDay | Hardcoded to 8 | |
| Pay rate | Package | ||
| Pay Currency | Currency | ||
| Is annual scale | IsAnnual | Boolean check | |
| (N/A) | Working Days | Hardcoded: Monday to Friday = True | |
| Tax Profile | Start Date | EmploymentDate | Also maps to GroupJoinDate |
| (N/A) | TempWorker | Hardcoded to False | |
| Integration | Legal Entity | CompanyId | Mapping based on settings |
| Monthly Frequency | CompanyFrequency | From Deel Local Payroll API (Create only) |
Known Limitations
- Data flows from Deel > Deel Local Payroll. Any edits made directly in the Deel Local Payroll interface will not update the employee's record in Deel.
- Deel Local Payroll requires certain fields (like Gender and Title) that are optional or do not exist in Deel. To prevent sync failures when optional Deel fields are empty, the system uses fail-safe defaults:
- Gender: Defaults to Male.
- Title: Defaults to Mr.
- Initials: Defaults to first and last name initials
- Work Schedule: defaults to Monday to Friday
- Race: defaults to Other
FAQs
Why isn't my new hire appearing in PaySpace?
Check the worker's status in Deel. They must be fully Onboarded
or Active.
You can also check the Event Log in the integration settings; if a mandatory
field such as Work Email is missing, the sync will pause
for that individual.
How do employees see their payslips?
Once you close the month in PaySpace, the integration pulls the payslip PDF. Employees can then find them under the Compliance or Payslips tab in their Deel dashboard.
What happens if I change an employee's salary in Deel?
The change will automatically be pushed to PaySpace. We recommend always verifying the update in PaySpace before finalizing your
monthly pay run to ensure effective dates were captured correctly.