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: Set up the integration role

To connect Oracle HCM to Deel, you need to create a dedicated integration role. Deel provides two methods. Choose the one that works best for your security and compliance requirements.

 

Method 1: Manual role creation

If you prefer to build the role manually or need to apply additional customizations, create the role directly in Oracle HCM using the privilege list provided in the Oracle HCM Integration Overview. This method gives you full control over the role configuration.

  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_API").
  5. Add the 27 required privileges. For the complete list, see the Oracle HCM Integration Overview. You can copy the role codes and paste them in bulk if Oracle's UI supports batch import.
  6. Review the role configuration to ensure only necessary permissions are included.
  7. Save your custom role.

 

Method 2: Zip file import (simplified)

Deel provides a pre-built role bundle that you can import directly into Oracle. This is the quickest method and ensures all privileges are correctly configured without manual entry.

  1. Download the role bundle. Deel will provide you with DEEL_INTEGRATION_API_20260702.zip. Keep the file as-is; do not unzip it.
  2. Open Users and Security in Setup. In Oracle, go to Setup and Maintenance, then select the Users and Security functional area. Locate the Manage Job Roles task.
  3. Import the bundle. On the Manage Job Roles row, open the Actions menu and select Import from CSV File > Create New. This is the same menu used for exports.
  4. Upload and submit. Upload the DEEL_INTEGRATION_API_20260702.zip file, optionally name the import process, then click Submit. Oracle reads the role and all 27 privileges directly from the bundle.
  5. Verify completion. Wait for the import process to finish. Then search for DEEL_INTEGRATION_API under Manage Job Roles to confirm it exists.

 

After setting up the role

Once your role is created or imported using either method, proceed to Step 2. The role is now ready to be assigned to your integration user.

 

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

Bulk Uploading Users to Oracle HCM

You can bulk upload user data to Oracle HCM to create or update multiple workers at once. To ensure Deel captures these bulk-uploaded changes, you must first enable Atom feeds in Oracle HCM. Without Atom feeds enabled, bulk-uploaded user data will not sync to Deel.

 

Step 1: Enable Atom Feeds in Oracle HCM

Atom feeds allow Deel to detect and sync all changes made through bulk uploads and other Oracle HCM data operations. Before you perform any bulk uploads, enable Atom feeds using the following SQL command:

  1. Log in to Oracle HCM as an administrator with database access.
  2. Open your SQL command interface (SQL*Plus or equivalent).

  3. Run the following command:

    SET ENABLE_INCREMENTAL_LOAD_EVENTS Y
  4. Press Enter to confirm. Atom feeds are now enabled and will capture all data changes going forward.

Step 2: Prepare and Upload Your Bulk Data File

Once Atom feeds are enabled, you can upload your bulk worker data to Oracle HCM:

  1. In Oracle HCM, navigate to Data Exchange > HCM Data Loader > Import and Load Data.
  2. In the Data Sets section, click the Import File button or select an existing data set.
  3. Choose your bulk upload file (must be in .zip format) from your local machine.
  4. Click Submit to upload the file. The system begins processing the import. 

Step 3: Monitor Upload Progress

Track the status of your bulk upload in the HCM Data Loader:

  1. Watch the Import Progress and Load Progress indicators for your uploaded file.
  2. Once both indicators show 100%, the import and load are complete.
  3. Verify that the Import Status and Load Status both show green checkmarks (success).
  4. If any status shows red or displays error messages, review the error log in the HCM Data Loader to identify and correct the issue, then resubmit.

Step 4: Deel Syncs the Updated Data

When your bulk upload completes successfully in Oracle HCM, Atom feed events are automatically generated for all changes. Deel automatically picks up these Atom feed events during the next sync cycle:

  1. Oracle HCM triggers Atom feed events for all bulk-uploaded worker records.
  2. Deel's People Data Sync plugin detects the Atom feed events and pulls the updated worker data.
  3. Syncs occur daily at 12:00:00 UTC. Updated workers will appear in your Deel account within 24 hours of upload completion.
  4. Verify the changes in Deel by checking the affected worker records in your Deel account. 

 

Atom Feeds must be enabled first

Always enable Atom feeds (Step 1) before performing bulk uploads. If you perform bulk uploads without Atom feeds enabled, Deel will not receive or sync those updates. Re-enable Atom feeds, then resubmit your bulk upload.

 

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 24 hours. 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