Overview

You can create and use your own Front partner credentials to connect to your customers’ Front workspaces. To set this up, sign up for an Front Developer account and create an OAuth app.

The steps below walk you through the full setup process:

Instructions

Step 1: Create a Front developer account and create your OAuth app

1. Sign up for a free Front developer account if you don't already have one.

2. After signing into your sandbox account, click the gear settings icon in the left side menu bar

3. Within your Front settings page, select Company. This may be an icon of a building like in the following image:

   

4. Click Developers in the submenu

5. Click Create app in the upper right side. This will create an Untitled app and take you to its own page.

   

   1. Under Settings tab, provide an App name and Short description.

      1. Edit the default app icon to add your company's icon.

         1. Front recommends using a 160x160 px PNG with a transparent background

            

   2. Click on the Features tab

      1. Click Add feature.

      2. Search for and select the OAuth feature.

         

      3. Click Add Redirect URL to authorize a URL for the server to redirect to after a successful authorization.

         1. Set this url to https://app.merge.dev/oauth/callback

      4. Specify the features, namespaces, and permissions that you want users to authorize for your token.

         1. Under Feature access, check Access resources

         2. Under Namespace access, check:

            1. Global resources

            2. Shared resources

               

         3. Under Resource permissions, check:

            Resource	Description
            Accounts	Read, Write, Delete
            Analytics	Read
            Attachments	Read
            Channels	Read, Write
            Comments	Read, Write
            Contacts	Read, Write, Delete
            Conversations	Read, Write
            Custom fields	Read
            Drafts	Read, Write, Delete
            Events	Read
            Inboxes	Read, Write
            Knowledge bases
            Links	Read, Write
            Message templates	Read, Write, Delete
            Messages	Read, Write, Send
            Rules	Read
            Shifts	Read
            Signatures	Read, Write, Delete
            Statuses	Read
            Tags	Read, Write, Delete
            Teammate groups	Read, Write, Delete
            Teammates	Read, Write
            Teams	Read
            Time off
            Views	Read, Write

            

6. Click Save

7. After the page refreshes, copy the Client ID and Client secret.

Step 2: Enter your app's details in the Merge Dashboard

1. Navigate to the Integrations > Ticketing page in the Merge dashboard

2. Expand the Front selection and select Edit to enter your credentials, and eventually switch to them.

   1. Select Edit to enter your credentials

      

   2. Under select credentials, select My credentials

      

3. Populate your credentials:

   1. OAuth Client Id: Your Client ID from the first step

   2. OAuth Client Secret: Your Client secret from the first step

   3. Redirect URI: https://app.merge.dev/oauth/callback

      

4. Click Save