Skip to content
Last updated

Help Scout integration

Help Scout is a customer support platform that brings email, live chat, and knowledge base tools into one shared inbox. The Help Scout integration with Frontegg allows your application to access and manage Help Scout mailboxes, conversations, customers, tags, and users on behalf of your users.


Prerequisites

  • A Help Scout account with admin or account owner access
  • Access to the My Apps section in your Help Scout profile

Connect Help Scout

Step 1: Open the My Apps page

Sign in to Help Scout and click your avatar in the top-right corner. Select Your Profile from the dropdown menu, then click My Apps in the left sidebar. The My Apps page displays any existing OAuth applications and provides a Create App button.

Help Scout My Apps page with Create App button highlighted

Step 2: Create a new application

Click Create App. In the dialog that appears, fill in the following fields:

  • App Name: Frontegg Integration
  • Redirection URL: https://YOUR_MCP_GATEWAY_URL/integration-callback

Click Create.

Create Custom App dialog with name and redirect URL filled in

Step 3: Copy credentials

After creation, Help Scout displays your App ID and App Secret on the app details page. Copy both values and store them securely.

Save your App Secret

Copy your App Secret immediately after creation. You will need it to configure the integration in the Frontegg portal.

Help Scout app details page showing App ID and App Secret

Step 4: Verify the redirect URL

On the same page, confirm that the Redirection URL field contains the correct Frontegg callback URL:

https://YOUR_MCP_GATEWAY_URL/integration-callback

Help Scout app details with Redirection URL highlighted

Configure the Frontegg portal

Once you have obtained your App ID and App Secret from the steps above, enter them in the integration configuration page of the Frontegg portal:

  1. Open the Frontegg portal and navigate to your environment → IntegrationsHelp Scout.
  2. Enter the App ID as the Client ID and the App Secret as the Client Secret in the corresponding fields.
  3. Select the required scopes.
  4. Click Save.

Available scopes

Help Scout scopes are passed during the OAuth authorization flow, not configured in the developer portal. The following scopes are available:

ScopeDescription
mailboxes:readRead mailbox data
conversations:readRead conversations
conversations:writeCreate and update conversations
customers:readRead customer data
customers:writeCreate and update customers
reports:readRead reports
users:readRead user data
tags:readRead tags
teams:readRead team data
webhooks:writeManage webhooks

Keep your credentials secure

Never share or commit your App Secret to version control.

Additional resources