Asymbl- How do I set up my partner credentials for OAuth?

Last updated: April 14, 2026

Overview

This guide will walk you through how to create an External Client App in Asymbl and enter your OAuth credentials in Merge.

Instructions

Step 1: Create an External Client App in Asymbl

  1. Log into Asymbl. Click the Gear Icon, and then click "Setup" from the drop down menu.

    Screenshot 2026-04-13 at 11.12.22 AM.png

  2. Using the Quick Find Search box, search App, and select External Client App Manager.

    Screenshot 2026-04-13 at 11.14.16 AM.png

  3. Click New External Client App

    Screenshot 2026-04-13 at 11.16.46 AM.png

    1. Enter a name for the App. Please note that it must be a unique name within your Organization.

    2. Enter an API Name, Contact Email, and select a Distribution State

    Screenshot 2026-04-13 at 11.19.42 AM.png

    1. In the API (Enable OAuth Settings) area of the page, check Enable OAuth Settings.

    2. In the App Settings, set the Callback URL to “https://app.merge.dev/oauth/callback”

    3. Add the three scopes below to the Select OAuth Scopes box

      • Access unique user identifiers (openid)

      • Manage user data via APIs (api)

      • Perform requests at any time (refresh_token, offline_access)

    4. Check the Require Secret for Web Server Flow box

    5. Check the Require Secret Refresh Token Flow box

      Screenshot 2025-10-03 at 3.32.50 PM.png

  4. Click Create to finalize completing your app setup.

Step 2: Set OAuth Policies

  1. On the External Client App Manager screen, find the App that you created and click it to open its record

  2. Under the Policies tab, click Edit, then open the OAuth Policies dropdown.

    Screenshot 2025-10-03 at 3.38.38 PM.png

  3. Make sure the Refresh Token Policy is set to: Refresh token is valid until revoked.

  4. Make sure the IP Relaxation is set to: Enforce IP restrictions, but relax for refresh tokens.

    Screenshot 2026-04-13 at 11.33.40 AM.png

Don't leave this page yet!

Step 3: Find and enter your Partnership credentials in Merge Dashboard

  1. On the External Client App Manager screen for your app, click the Settings tab

  2. Click open OAuth Settings

  3. Click the Consumer Key and Secret link

    Screenshot 2025-10-03 at 6.50.05 PM.png

  4. Fetch your Client ID and Secret on the next page and save them for the next step

  5. Copy the following values and enter them in the Merge Dashboard

    1. OAuth Client Id

    2. OAuth Client Secret

    3. OAuth Redirect Uri: https://app.merge.dev/oauth/callback

Screenshot 2026-03-31 at 12.19.02 PM.png