> ## Documentation Index
> Fetch the complete documentation index at: https://stackone-hub-docs-confluence-api-token-update.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Oracle HCM

> Follow these steps to connect Oracle HCM with StackOne Hub successfully.

<Warning>
  Ensure you have Admin privileges for your Oracle HCM account.
</Warning>

If you've been directed to StackOne to integrate with Oracle HCM, the following steps will help you understand the process and any necessary actions to configure successful integration.

## Get your Rest Server URL

You can find the REST Server URL, username, and password in the welcome email sent to your Oracle Cloud service administrator. This is typically the URL of your Oracle Cloud service. Example: `https://servername.fa.us2.oraclecloud.com`.

## Create a Service User with Required Roles

<Steps>
  <Step title="Access Setup and Maintenance">
    Within your Oracle Cloud Vision instance in the left side navigation panel, expand My Enterprise, then click Setup and Maintenance.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Setup and Maintenance" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/MGnlGQ2FDcYjia7O/images/oraclehcm/image1.png?fit=max&auto=format&n=MGnlGQ2FDcYjia7O&q=85&s=b06d28ec9c31f4b84220921176e9a014" width="1228" height="777" data-path="images/oraclehcm/image1.png" />
    </Frame>
  </Step>

  <Step title="Manage Job Roles">
    Under "Functional Areas", click Users and Security. Then on the right, click Manage Job Roles.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Manage Job Roles" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/MGnlGQ2FDcYjia7O/images/oraclehcm/image2.png?fit=max&auto=format&n=MGnlGQ2FDcYjia7O&q=85&s=5ae4de1070456ce3ba943bc2664e4dfa" width="1678" height="738" data-path="images/oraclehcm/image2.png" />
    </Frame>
  </Step>

  <Step title="Add User Account">
    In the left navigation panel, click Users. Then click the Add User Account button in the top right.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Add User Account" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/MGnlGQ2FDcYjia7O/images/oraclehcm/image3.png?fit=max&auto=format&n=MGnlGQ2FDcYjia7O&q=85&s=682734cddb75da445c68aac59a7890f8" width="1679" height="690" data-path="images/oraclehcm/image3.png" />
    </Frame>
  </Step>

  <Step title="Enter User Information">
    Enter the new User Information for the new Service User to be authorized for this integration. Store these credentials safely. The required fields are:

    <ul>
      <li>Last Name</li>
      <li>Username</li>
      <li>Password</li>
      <li>Confirm Password</li>
    </ul>

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="User Information" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/MGnlGQ2FDcYjia7O/images/oraclehcm/image4.png?fit=max&auto=format&n=MGnlGQ2FDcYjia7O&q=85&s=87a45f849bcc43528cfbffc78caae6df" width="1673" height="780" data-path="images/oraclehcm/image4.png" />
    </Frame>
  </Step>

  <Step title="Add Required Roles">
    Determine the required roles based on the integration category. The HRIS integration requires the following roles:

    <ul>
      <li>ORA\_RECRUITER\_JOB</li>
      <li>PER\_RECRUITING\_ADMINISTRATOR\_JOB</li>
      <li>ORA\_IRC\_RECRUITING\_AGENT\_JOB</li>
      <li>ORA\_RECRUITING\_MANAGER\_JOB</li>
      <li>PER\_HUMAN\_RESOURCE\_SPECIALIST\_JOB</li>
      <li>ORA\_HRC\_HUMAN\_CAPITAL\_MANAGEMENT\_INTEGRATION\_SPECIALIST\_JOB</li>
    </ul>

    Press the Add Role button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Add Role" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/MGnlGQ2FDcYjia7O/images/oraclehcm/image5.png?fit=max&auto=format&n=MGnlGQ2FDcYjia7O&q=85&s=ec6d5db9aa40fa8542a48c01c00ccbaa" width="1673" height="780" data-path="images/oraclehcm/image5.png" />
    </Frame>
  </Step>

  <Step title="Search and Add Roles">
    In the window that appears, for each required role:

    <ol>
      <li>Paste the role name into the Search box. Click the first result to populate the search results.</li>
      <li>Click the role result matching the correct Code. Then click the Add Role Membership button.</li>
    </ol>

    Continue until all required roles are added, then click Done.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Search and Add Roles" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/kA_-fzt7TEYGckYp/images/oraclehcm/image6.png?fit=max&auto=format&n=kA_-fzt7TEYGckYp&q=85&s=0ec58c927353fc528cc82903a0010a00" width="1244" height="718" data-path="images/oraclehcm/image6.png" />
    </Frame>
  </Step>

  <Step title="Save and Close">
    Confirm that the User Information and Roles are correct, then click the Save and Close button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Save and Close" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/kA_-fzt7TEYGckYp/images/oraclehcm/image7.png?fit=max&auto=format&n=kA_-fzt7TEYGckYp&q=85&s=185e0883adfd86ec2229f9476384dbc5" width="1085" height="674" data-path="images/oraclehcm/image7.png" />
    </Frame>
  </Step>
</Steps>

## Connecting to StackOne

<Steps>
  <Step title="Enter Service User Details">
    Upon reaching the Link Account page, enter the Service User's Username and Password from the previous step, and the Rest Server URL. Proceed by clicking the Connect button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Link Account" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/kA_-fzt7TEYGckYp/images/oraclehcm/image8.png?fit=max&auto=format&n=kA_-fzt7TEYGckYp&q=85&s=ef10a24259db9dd4031f32e8c59166ab" width="1056" height="643" data-path="images/oraclehcm/image8.png" />
    </Frame>
  </Step>
</Steps>

<br />

Congratulations, you're all set! If you face any issues with the steps mentioned above,
please contact us by emailing [integrations@stackone.com](mailto:integrations@stackone.com). We're always here to assist you!

## Useful Links

<Card title="API Reference" icon="link" href="https://docs.oracle.com/en/cloud/saas/human-resources/23d/farws/index.html">
  [https://docs.oracle.com/en/cloud/saas/human-resources/23d/farws/index.html](https://docs.oracle.com/en/cloud/saas/human-resources/23d/farws/index.html)
</Card>