Help Scout Mailbox API

Name: Help Scout Mailbox API
Brand: Help Scout Mailbox API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentCRMCustomer Supportoauth232 EndpointsREST

For Agents

Read and write Help Scout conversations, customers, threads, tags, and webhooks across shared inboxes through an OAuth 2.0 REST API.

Connect the Help Scout Mailbox API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Help Scout Mailbox API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Install Jentic One Beta (Self-Hosted)

Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Help Scout Mailbox API.

List and search conversations across mailboxes with filters for status, assignee, and tags

Create and reply to conversations on behalf of a Help Scout user

Add internal notes to a conversation without notifying the customer

Create, update, and merge customer records

GET STARTED

Start building with Help Scout Mailbox API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI specification for Help Scout Mailbox API, keeping it validated and agent-ready. The Help Scout Mailbox API exposes shared inboxes, customer profiles, conversations, and the threads and notes inside each conversation, alongside tags, teams, users, webhooks, workflows, and reporting. It is the integration surface for replicating Help Scout data into a CRM, automating support workflows, or letting an external tool reply to customers from Help Scout. The API is HTTPS-only with OAuth 2.0 authentication and CORS support.

Use Cases

Patterns agents use Help Scout Mailbox API for, with concrete tasks.

★ External Forms to Help Scout Conversations

Public contact forms or in-app feedback widgets can POST a new conversation directly into Help Scout so the support team picks it up in their existing inbox. The conversation includes the customer email, subject, and an initial customer thread, and Help Scout assigns it to the configured mailbox. This avoids forwarding from a generic inbox and keeps the support team in their primary tool.

POST /conversations with mailboxId, customer email, subject, and an initial customer thread.

AI-Assisted Replies in Customer Support

An AI-assisted support tool can pull the latest customer thread from a conversation, draft a reply, and post it back via /conversations/{conversationId}/reply once a human has approved it. Internal notes can be used to record the AI suggestion before it is sent, keeping a clear audit trail. This adds drafting throughput without giving the AI direct send authority.

GET /conversations/{conversationId}/threads, draft a reply, POST /conversations/{conversationId}/notes for the AI suggestion, then POST /conversations/{conversationId}/reply once approved.

Replicating Conversations into a CRM

Sales and customer success teams that live in a CRM can replicate Help Scout conversations into the CRM by listing conversations on a schedule and resolving each customer to a CRM contact. Tag changes and new threads can be picked up via webhooks to keep the CRM current. This stitches support history into the contact timeline without duplicating data entry.

GET /conversations with status=active, GET /customers/{customerId} for each, and write the rolled-up record into the CRM.

AI Agent Triaging Inbound Mail

An AI agent can subscribe to Help Scout new-conversation webhooks via Jentic, pull the conversation and customer, classify the intent, and apply tags or move the conversation to the right mailbox. Jentic stores the OAuth credentials and only exposes the operations the agent needs, so triage logic stays narrow and auditable. This is a high-leverage pattern for support teams handling many low-effort tickets.

Search Jentic for 'tag a help scout conversation', load PUT /conversations/{conversationId}/tags, and execute with the predicted tags.

Key Endpoints

32 endpoints — jentic publishes the only available openapi specification for help scout mailbox api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/conversations

List conversations with filters

POST

/conversations

Create a conversation

PATCH

/conversations/{conversationId}

Update a conversation

POST

/conversations/{conversationId}/reply

Reply to a conversation

POST

/conversations/{conversationId}/notes

Add an internal note to a conversation

PUT

/conversations/{conversationId}/tags

Update conversation tags

GET

/customers

List customers

POST

/customers

Create a customer

GET

/conversations

List conversations with filters

POST

/conversations

Create a conversation

PATCH

/conversations/{conversationId}

Update a conversation

POST

/conversations/{conversationId}/reply

Reply to a conversation

POST

/conversations/{conversationId}/notes

Add an internal note to a conversation

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Help Scout OAuth client credentials are stored encrypted in the Jentic vault. Jentic refreshes the bearer access token automatically and adds the Authorization header at execution time, so the agent never sees the token.

Intent-based discovery

Agents search by intent (e.g., 'reply to a help scout conversation') and Jentic returns the matching Help Scout operation with its input schema, including the conversation and thread shapes.

Time to first call

Direct Help Scout integration: 2-4 days for OAuth 2.0 flow, token refresh, and webhook signature verification. Through Jentic: under an hour to make the first authenticated API call.

FAQs

Specific to using Help Scout Mailbox API through Jentic.

Why is there no official OpenAPI spec for Help Scout Mailbox API?

Help Scout publishes developer documentation but no fully validated OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Help Scout Mailbox API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Help Scout Mailbox API use?

Help Scout uses OAuth 2.0 with bearer access tokens. Apps obtain tokens via the client credentials or authorization code flow, then send Authorization: Bearer {token} on each call. Tokens are short-lived; refresh them before expiry. Jentic stores client credentials in its vault and refreshes tokens automatically.

Can I reply to a conversation through the Help Scout API?

Yes. POST /conversations/{conversationId}/reply creates a customer-visible reply on behalf of a Help Scout user. POST /conversations/{conversationId}/notes adds an internal note that customers do not see — useful for AI suggestions or handover comments.

What are the rate limits for the Help Scout Mailbox API?

Help Scout enforces per-app rate limits documented in their developer portal — typically a per-minute ceiling per access token. Respect 429 responses and the Retry-After header. For bulk reads, paginate with the Link header rather than tightening loops.

How do I tag a conversation through Jentic?

Search Jentic for 'tag a help scout conversation', load the PUT /conversations/{conversationId}/tags schema, and execute with the conversation ID and the desired tags. Jentic supplies a fresh access token from the vault.

Can the API subscribe to new-conversation events?

Yes. Help Scout supports webhooks for events such as conversation creation, replies, and tag updates. Register a webhook URL via the webhooks resource and verify incoming payloads with the signing secret to filter spoofed callbacks.

Help Scout Mailbox API

Connect the Help Scout Mailbox API to your agent

Capabilities

Start building with Help Scout Mailbox API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs