Skip to main content
The Help Scout integration seamlessly connects your website forms to your customer support helpdesk. Instead of relying on email forwarding (which strips out crucial metadata and ruins threading), Flex Forms connects directly to the Help Scout API to generate clean, native “Conversations” in a specific Mailbox.

​
Enterprise Business Use Cases

Instant Support Ticketing

When a customer fills out a complex bug report form, Flex Forms creates a new Conversation in Help Scout. It correctly maps their email address as the “Customer”, meaning when your agents reply in Help Scout, it goes directly to the user.

​
Ultra-Detailed, Step-by-Step Setup Guide

Connecting Flex Forms to Help Scout requires generating an App ID and an App Secret via an OAuth2 flow. Follow these exact instructions to ensure the integration is properly authenticated.
1

Step 1: Log into Help Scout

Open your web browser and navigate to your Help Scout dashboard. Enter your credentials to log in.Note: You must have Administrator privileges to create OAuth applications.
2

Step 2: Access the User Profile Menu

Look at the absolute top right corner of your screen. Click on your profile icon (or the avatar silhouette).
3

Step 3: Navigate to Your Profile

In the dropdown menu that appears, click exactly on the link labeled Your Profile.
4

Step 4: Access 'My Apps'

You are now viewing your profile settings. Look at the left-hand sidebar menu. Click exactly on the link labeled My Apps.
5

Step 5: Create a New App

On the My Apps page, click the prominent blue button labeled Create My App. A configuration form will appear.
6

Step 6: Configure the Application Details

Fill out the form with the following exact details:
  • App Name: Flex Forms Website Integration
  • Redirection URL: You MUST enter https://your-domain.com (Replace with your actual website URL). Even though this is a server-to-server integration, Help Scout requires a valid, secure HTTPS URL here.
Click the Create button.
7

Step 7: Copy the App ID and Secret

You will be redirected back to the My Apps overview, and your new Flex Forms Website Integration app will be listed. Click on it.You will now see two strings of text: the App ID and the App Secret.Highlight the App ID, right-click, and select Copy.
8

Step 8: Inject Credentials into Flex Forms

Switch to your Flex Forms administrative dashboard in a new tab.
  1. Open Integrations (Flex Forms left rail) → Help Scout.
  2. Paste the App ID into the App ID field.
  3. Switch back to Help Scout, copy the App Secret, and paste it into the App Secret field in Flex Forms.
  4. Click the Save Settings button to finalize the secure OAuth connection.

​
Masterclass: Routing to Mailboxes

Establishing the connection allows data to flow, but you must instruct Flex Forms exactly which “Mailbox” should receive the new Support Conversations.
Mailbox ID Requirement: You must provide the specific Mailbox ID in the form’s integration settings. To find this, open your Help Scout dashboard, click on the specific Mailbox you want to route to (e.g., “Support”), and look at the URL in your browser. The URL will look like .../mailbox/123456/.... That number is your Mailbox ID.

​
Field Mapping Architecture

Flex Forms handles the complex API logic of associating the user’s email address with a Help Scout Customer Profile automatically (meaning you do not need to manually map the email field). Furthermore, Flex Forms intelligently compiles all the other answers the user provided into a clean, HTML-formatted block and injects it into the Conversation Thread.
You can map a specific form field to act as the primary Subject Line of the Help Scout Conversation.The format is always: subject=flex_forms_block_name
If you do not map the subject field, Flex Forms will generate a generic subject (e.g., “New Form Submission - [Date]”).

​
Troubleshooting & Enterprise FAQs

The Problem: The server logs show a 401 Unauthorized error when attempting to create a Conversation.The Solution: This almost always means either your App ID or App Secret is incorrect, or contains a trailing space. Verify both credentials against the Help Scout dashboard.
The Problem: The server logs show a 400 Bad Request regarding the Mailbox.The Solution: The Mailbox ID you pasted into the form settings is incorrect, or the OAuth App you created does not have permission to access that specific Mailbox. Double-check the ID from the URL.

​
Configuration Reference

The following advanced settings are available in the Flex Forms UI for this integration. Use this reference to understand exactly how each field impacts the API payload.

​
Global Settings

Located in Integrations in the Flex Forms left rail.
​
password
required
Access token Help Scout OAuth access token with mailbox and customer scopes.

​
Form-Level Settings

Located on the form hub Integrations tab for a specific form.
​
remote_select
required
Mailbox
​
remote_select
Assign to Mailbox-scoped Help Scout users and teams (Teams listed as “Team: …”).
​
select
Customer email field
​
select
Customer first name field
​
select
Customer last name field
​
select
Customer phone field
​
text
Tags Comma-separated. Supports merge tags.
​
text
required
Subject Supports merge tags.
​
textarea
required
Message body Supports merge tags.
​
textarea
Internal note Optional note thread prepended to the conversation. Supports .
​
select
default:"active"
StatusOptions:
  • active: Active
  • pending: Pending
  • closed: Closed
  • spam: Spam
​
select
default:"email"
TypeOptions:
  • email: Email
  • chat: Chat
  • phone: Phone
​
select
default:"0"
Send auto replyOptions:
  • 0: No
  • 1: Yes
​
text
Attachment fields Comma-separated upload field names to attach to the conversation.
​
text
CC Comma-separated. Supports merge tags.
​
text
BCC Comma-separated. Supports merge tags.
Last modified on September 7, 2026