Skip to main content

How to Connect Oracle HCM to Deel

Luiza Del Giudice De Carvalho
  • Updated

This guide walks you through connecting your Oracle HCM system to Deel. Once connected, you'll be able to sync worker data, payroll information, and time-off records between the two systems automatically.

 

In this article

 

Before you begin

In Oracle HCM

Make sure you have:

  • Administrator access to create roles, security profiles, and users
  • REST API must be enabled in your Oracle HCM instance
  • Access to the following areas:
    • Setup > Security > Roles
    • Setup > Security > Security Profiles
    • Setup > People > Users

In Deel

Make sure you have:

  • Admin access to Deel 

 

Oracle HCM setup

Step 1: Create a custom integration role

Create a new integration role with least-privilege permissions. This role will define exactly what the integration can access in your Oracle HCM system.

  1. Log in to Oracle HCM as an administrator.
  2. Navigate to Setup > Security > Roles.
  3. Click Create Role or select an existing role template to start from.
  4. Enter a name for the role (e.g., "Deel Integration").
  5. Add the following minimum required privileges:
  • Use REST Service - Worker as Worker
  • Use REST Service - Worker Employment
  • Use REST Service - Worker Assignments List of Values 
  • Use REST Service - Absences 
  • Use REST Service - Document Records
  • Use REST Service - Payroll List of Values
Info
Tip
For the full list of available privileges, see the Oracle HCM Integration Overview.
  1. Review the role configuration to ensure only necessary permissions are included.
  2. Save your custom role.

 

Step 2: Configure security profiles

Security profiles determine what data the integration user can access. For integrations, use a View All profile to ensure access to all necessary records.

  1. Log in to Oracle HCM as an administrator.
  2. Navigate to Setup > Security > Security Profiles.
  3. Select or create a “View All" security profile.
  4. Verify it includes:
  • View all organizations
  • View all positions
  • No organizational or positional limitations
  1. Note the security profile name. You'll assign it to your integration user in Step 3.

 

Step 3: Create the integration user

  1. Log in to Oracle HCM as an administrator.
  2. Navigate to Setup > People > Users.
  3. Click New User.
  4. Enter the following information:
  • Username: deel_integration (or similar identifier)
  • Email: integration contact email
  • User Type: Service Account (if available) or Standard
  • Status: Active
  1. Assign the custom integration role from Step 1.
  2. Assign the security profile from Step 2.
  3. Record the password you set for this user. You'll need it to connect to Deel.
  4. Save the user.

 

Deel setup

Step 4: Connect Oracle HCM in Deel

  1. In Deel, go to Apps & Automations > App store in the left menu. 
  2. Search Oracle HCM, then click Connect to Oracle HCM.
  3. Enter the following information:
  • Base URL: Your Oracle HCM instance URL (e.g., https://your-instance.oracle.com)
  • Username: deel_integration (the integration user you created in Step 3)
  • Password: The password you set for the integration user
  1. Click Connect.

Your Oracle HCM system is now connected to Deel. The form automatically saves your progress, so you can return to this page if you need to make changes.

 

Step 5: Review available plugins

Once connected, you'll see a list of available plugins. These plugins allow you to sync different types of data:

Plugin Function Default State
Global Payroll - People Data Sync Syncs onboarding, amendments, and terminations for direct employees Disabled
Global Payroll - External Payroll Documents Sync Syncs contracts, payslips, and compliance documents from Deel to Oracle HCM Disabled
Global Payroll - Time Off Sync Allows direct employees to log time off in Oracle HCM; Deel syncs the data periodically Disabled
Global Payroll - One Time Payment Sync Syncs variable pay and entitlements from Oracle HCM to Deel Disabled
Global Payroll - Recurring Payment Sync Syncs recurring payments such as allowances, deductions, and benefits from Oracle HCM to Deel Disabled

 

Step 6: Enable People Data Sync

For the initial setup, we recommend starting with Global Payroll - People Data Sync. Additional plugins can be enabled later.

 

Add entities

  1. In the Configurations and Plugins section, locate Global Payroll - People Data Sync.
  2. Click the Enable button.
  3. You'll be taken to the plugin configuration screen. Complete the required setup:
  • In the "Entity list" section, click Add entity.
  • Select the Oracle HCM teams and legal entities you want to sync:
    • Choose the Oracle HCM team
    • Select the corresponding Deel entity
  • Click Add. The entity will appear in the Entity list with a status of "Setting up" or "Syncing".
  • Repeat for each Oracle HCM team/entity pair you want to sync.
Warning
Entities may show error indicators if the configuration is incomplete
See the errors and complete any required setup for those entities.

 

Configure data mapping

  1. In the Data/Item mapping section, you'll see two types of mappings:
  • Generic items: These mappings apply to all entities within your organization. Status shows [n]/[n] mapped (e.g., 18/18 mapped).
  • Country-specific items: These mappings apply only to entities in a specific country. Click to expand and configure per country.
  1. If any mappings are missing or incomplete, click Edit to configure them. You can map Oracle HCM data fields to the corresponding Deel fields.
  2. Once all required mappings are complete, the plugin is fully configured and will begin syncing data according to your schedule.

 

Configure additional settings (Optional)

  1. In the Additional settings section, set the following:
  • Termination Cutoff Date - Only employees terminated after this date will be synced. Terminations on or before this date are excluded
  • Send GP login invites automatically - Toggle to enable or disable automatic sending of Global Payroll login invites to synced employees

 

Test your connection

Before enabling full production sync, test the integration with sample data.

Create a test worker in Oracle HCM

  1. Navigate to Setup > Administer Workers.
  2. Create a new worker with test data:
  • Name: Test Worker
  • Email: test.worker@example.com
  • Start date: today's date
  • Job title: Test Job Title
  1. Fill in all required fields.
  2. Check the Transaction Controller to confirm automatic approval.
  3. Navigate to Person Management to view the activated record.
  4. Assign an active assignment with appropriate dates and positions.

 

Verify the test worker in Deel

  1. In Deel, check that the test worker appears in the People directory.
  2. Confirm the following information matches:
  •  Name and email
  •  Job title
  •  Department/organization
  •  Employment dates
  1. Review sync logs in the Event Logs tab.

 

Test termination workflow (optional)

If you plan to use termination sync:

  1. Ensure your test worker is in "Active" status (not "Pending").
  2. In Oracle HCM, navigate to Terminate Employment.
  3. Locate your test worker and complete the termination with:
  •  Termination date
  •  Termination reason
  •   Any other required information
  1.  Verify the termination syncs to Deel within 24h. Syncs happen daily at 12:00:00 UTC.

 

Troubleshooting test results

If data doesn't sync as expected:

  • Verify the integration user has the correct permissions in Oracle HCM (custom role + security profile).
  • Verify the Base URL, username, and password are correct in the Deel connection settings.
  • Check that all required fields in Oracle HCM are populated.
  • Review sync logs in Deel for specific error messages.
  • If issues persist, contact support.
Was this article helpful?
0 out of 0 found this helpful
Was this article helpful?
not helpful
very helpful
Return to top

Related articles