Skip to main content
A user account with HCM REST API privileges is required. Basic authentication is recommended for testing only - use OAuth 2.0 for production.

​
Finding Your REST Server URL

The REST Server URL is the base URL for your Oracle Fusion HCM instance. You can find this in the welcome email sent to your Oracle Cloud service administrator.

1

Identify Your Instance URL

Sign in to your Oracle Cloud account. Your REST Server URL follows this format:

  • Format: https://servername.fa.{datacenter}.oraclecloud.com
  • Example: https://mycompany.fa.us2.oraclecloud.com
  • The URL is visible in your browser address bar when logged into Oracle Fusion HCM
  • Copy the base URL without any trailing paths and store it securely for use later

​
Creating a Service User

Create a dedicated service user with the required roles for API access. Admin privileges are required to create users.

1

Access Setup and Maintenance

In your Oracle Cloud instance, expand My Enterprise in the left navigation panel, then click Setup and Maintenance.

2

Navigate to Users

Under Functional Areas, click Users and Security. Then click Manage Job Roles on the right. In the left navigation panel, click Users.

3

Create the Service User

Click the Add User Account button and enter the user information.

  • Last Name (required)
  • Username (required) - e.g., StackOne_Integration
  • Password and Confirm Password (required)
  • Store these credentials securely for use later
4

Add Required Roles

Click the Add Role button and add the following required roles by searching for each role name.

  • ORA_HRC_HUMAN_CAPITAL_MANAGEMENT_INTEGRATION_SPECIALIST_JOB
  • ORA_PER_RECRUITING_ADMINISTRATOR_JOB
  • ORA_FND_ANONYMOUS_USER_ABSTRACT
  • ORA_IRC_HIRING_MANAGER_ABSTRACT
  • Add additional roles based on the data you need to access
5

Save and Close

Confirm that the user information and roles are correct, then click Save and Close.

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • Service User Username
  • Service User Password
  • REST Server URL
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.