Overview

This guide walks you through the process of setting up an OAuth application in CezanneHR so you can use your own credentials when connecting via Merge. Using your own credentials provides a branded experience and may offer more control over data access scopes.

Instructions

Step 1: Log in to CezanneHR

1. Sign in to your CezanneHR account.

2. Navigate to the Administration section by selecting the tool icon in the left sidebar.

Step 2: Create a New Authorized Application

1. In the left-hand menu, click Authorised Applications.

2. Click Add New at the bottom of the page.

3. In the pop-up modal, enter:

   • Name – e.g., “Merge”

   • Description – e.g., “Integration for Merge platform”

4. Click OK to create your application.

Step 3: Configure the Application Client

After saving, you’ll see your new application listed under Authorised Applications.

1. Click Advanced Configuration next to your new app.

2. Ensure Enable All Users is checked.

3. Copy the Client ID and Client Secret — you’ll need these for Merge.

4. Under Allowed Callbacks, add the following callback URLs (each on a new line):

   x-cez://oauth-callback/
   https://app.merge.dev/oauth/callback

Step 4: Enable Application Scopes

1. Navigate to the Application Scopes tab.

2. Turn ON all available scopes:

   • Token Information

   • API read access

   • API write access

Step 5: Add Credentials in Merge

Once your OAuth app is configured in CezanneHR, return to Merge and paste the Client ID and Client Secret into the linking flow.