{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-agen-for-work/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["Notification","LightboxImage"]},"type":"markdown"},"seo":{"title":"Help Scout integration","siteUrl":"https://developers.frontegg.com/","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"help-scout-integration","__idx":0},"children":["Help Scout integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Prerequisites","type":"attention"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A Help Scout account with admin or account owner access"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Access to the My Apps section in your Help Scout profile"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"connect-help-scout","__idx":1},"children":["Connect Help Scout"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-1-open-the-my-apps-page","__idx":2},"children":["Step 1: Open the My Apps page"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sign in to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://secure.helpscout.net"},"children":["Help Scout"]}," and click your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["avatar"]}," in the top-right corner. Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Your Profile"]}," from the dropdown menu, then click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["My Apps"]}," in the left sidebar. The My Apps page displays any existing OAuth applications and provides a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create App"]}," button."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/helpscout-1.d69a1d6257c942d1810e820219dc96d4abf92126228355ef2a61644eed505eb0.1ce25488.png","alt":"Help Scout My Apps page with Create App button highlighted"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-2-create-a-new-application","__idx":3},"children":["Step 2: Create a new application"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create App"]},". In the dialog that appears, fill in the following fields:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App Name"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Frontegg Integration"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Redirection URL"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://YOUR_MCP_GATEWAY_URL/integration-callback"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create"]},"."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/helpscout-2.5ff5f97a42d21df7139ec31073bb546db06cba42fc56e016acfaad8e62f76abb.1ce25488.png","alt":"Create Custom App dialog with name and redirect URL filled in"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-3-copy-credentials","__idx":4},"children":["Step 3: Copy credentials"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After creation, Help Scout displays your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App Secret"]}," on the app details page. Copy both values and store them securely."]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Save your App Secret","type":"attention"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Copy your App Secret immediately after creation. You will need it to configure the integration in the Frontegg portal."]}]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/helpscout-3.80764255a9a58fd8ada58e72153973926c6c8021712a4a723b756fe21a7ed8c6.1ce25488.png","alt":"Help Scout app details page showing App ID and App Secret"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-4-verify-the-redirect-url","__idx":5},"children":["Step 4: Verify the redirect URL"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On the same page, confirm that the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Redirection URL"]}," field contains the correct Frontegg callback URL:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://YOUR_MCP_GATEWAY_URL/integration-callback"]}]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/helpscout-4.7c186a756ee331410fd6c8eadaa62efa9a8d59ab7975241af9e6beec9aa17042.1ce25488.png","alt":"Help Scout app details with Redirection URL highlighted"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"configure-the-frontegg-portal","__idx":6},"children":["Configure the Frontegg portal"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once you have obtained your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App Secret"]}," from the steps above, enter them in the integration configuration page of the Frontegg portal:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Frontegg portal"]}," and navigate to your environment → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Integrations"]}," → ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Help Scout"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App ID"]}," as the Client ID and the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App Secret"]}," as the Client Secret in the corresponding fields."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the required ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["scopes"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Available scopes","type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Help Scout scopes are passed during the OAuth authorization flow, not configured in the developer portal. The following scopes are available:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Scope"},"children":["Scope"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mailboxes:read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read mailbox data"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["conversations:read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read conversations"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["conversations:write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create and update conversations"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customers:read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read customer data"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customers:write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create and update customers"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reports:read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read reports"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["users:read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read user data"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tags:read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read tags"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["teams:read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read team data"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhooks:write"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Manage webhooks"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Keep your credentials secure","type":"attention"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Never share or commit your App Secret to version control."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"additional-resources","__idx":7},"children":["Additional resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developer.helpscout.com/"},"children":["Help Scout API documentation"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developer.helpscout.com/mailbox-api/overview/authentication/"},"children":["Help Scout authentication guide"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developer.helpscout.com/mailbox-api/"},"children":["Help Scout Mailbox API reference"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/agen-for-work/connectors/redirect-url"},"children":["How to get your Redirect URL"]}]}]}]}]},"headings":[{"value":"Help Scout integration","id":"help-scout-integration","depth":2},{"value":"Connect Help Scout","id":"connect-help-scout","depth":3},{"value":"Step 1: Open the My Apps page","id":"step-1-open-the-my-apps-page","depth":4},{"value":"Step 2: Create a new application","id":"step-2-create-a-new-application","depth":4},{"value":"Step 3: Copy credentials","id":"step-3-copy-credentials","depth":4},{"value":"Step 4: Verify the redirect URL","id":"step-4-verify-the-redirect-url","depth":4},{"value":"Configure the Frontegg portal","id":"configure-the-frontegg-portal","depth":3},{"value":"Additional resources","id":"additional-resources","depth":3}],"frontmatter":{"seo":{"title":"Help Scout integration"}},"lastModified":"2026-05-01T18:45:25.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/agen-for-work/connectors/marketplace/helpscout","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}