MojarMojar
Connectors

Help Scout

Create conversations, send replies, and update status in Help Scout from a workflow.

The Help Scout connector lets your agent create new support conversations, reply to existing ones, fetch conversation details, and change a conversation's status — all as workflow steps.

What you can do

ActionWhat it does
Create conversationOpens a new email conversation in a Help Scout mailbox, with a subject, body, and customer email.
ReplyPosts a reply thread to an existing conversation.
Get conversationReads a conversation's subject, status, state, tags, and customer email.
Update statusChanges a conversation's status (e.g. to closed, active, or pending).

All text fields support {{variable}} template syntax.

Before you start

You need:

  • A Help Scout account with the Docs API or Mailbox plan.
  • A Help Scout App (OAuth2 client credentials) — an App ID and App Secret.
  • The Mailbox ID of the mailbox where conversations should be created.

Help Scout uses OAuth2 client credentials for machine-to-machine authentication. You create a "My App" to obtain the App ID and App Secret — no user login is required at runtime.

To create a Help Scout app and find your mailbox ID:

In Help Scout, click your profile picture in the top-right corner and choose Your Profile.
Go to My AppsCreate My App. Give it a name and note the App ID and App Secret.
To find your Mailbox ID, go to ManageMailboxes, click the mailbox you want to use, and read the number from the URL — for example, /mailboxes/12345 → ID is 12345.

Connect Help Scout

Open your agent in Mojar and go to Integrations in the sidebar.
Find HelpScout in the list of available providers and click Connect.

Fill in the credential form:

FieldValue
App IDThe OAuth2 client ID from Your Profile → My Apps
App SecretThe OAuth2 client secret from the same page
Mailbox ID (optional)Numeric ID of the default mailbox; can be overridden per node
Click Save. Mojar exchanges the credentials for a short-lived access token to verify the connection.

Help Scout connector credential form showing the App ID, App Secret, and optional Mailbox ID fields

Use it in a workflow

Open the workflow editor and add a new node where you want the Help Scout action.
Select HelpScout as the connector.
Choose an Action — Create conversation, Reply, Get conversation, or Update status.

Fill in the action fields. Key fields by action:

Create conversation

  • Subject — the conversation subject line
  • Body — the initial message body (HTML is supported)
  • Customer Email — the customer's email address (required)
  • Mailbox ID — overrides the default mailbox set in credentials
  • Status (optional) — defaults to active
  • Tags (optional) — comma-separated

Reply

  • Conversation ID — the numeric Help Scout conversation ID
  • Body — the reply text

Get conversation / Update status

  • Conversation ID — the numeric Help Scout conversation ID

Update status additionally requires:

  • Statusactive, closed, or pending
Connect the node's output to the next step. Created conversations return a conversationId you can reference in later nodes.

The Conversation ID is different from a ticket number visible to the customer. You can capture it from the output of a Create conversation node and pass it downstream via a workflow variable.

On this page