The API Report CardAPI Index
Help Scout

Help Scout API

Customer Support · helpscout.com

Help Scout offers two self-serve REST APIs: the Inbox API for conversations, customers, and reports, and a Docs API for knowledge bases. Any admin can register an OAuth 2.0 app in the UI. Tokens expire every 48 hours with no refresh flow, and writes count double against the 400 per minute cap.

Last verified: July 2026Software & Data Tools
API GRADE
A
VERIFIED JUL 2026

SCORECARD

ExistenceGOODTwo public REST APIs: Inbox (Mailbox 2.0) for the helpdesk and a Docs API for knowledge bases.
AccessGOODAny admin can register an OAuth app from the My Apps area of the UI, with no partner approval.
CoverageGOODConversations, customers, mailboxes, users, workflows, reports, ratings, and knowledge-base content.
AuthGOODOAuth 2.0 in both flows; client-credentials tokens expire after 48 hours with no refresh mechanism.
Docs & DXGOODOfficial PHP SDK, healthy community wrappers, real-time webhooks, and an in-product app framework.
StabilityGOOD
Supergood: Help Scout shipped a real API. Most vendors don't; we ship near-native APIs for the rest.

Frequently asked questions

Help Scout scores A on the API Report Card. Help Scout offers two self-serve REST APIs: the Inbox API for conversations, customers, and reports, and a Docs API for knowledge bases. Any admin can register an OAuth 2.0 app in the UI. Tokens expire every 48 hours with no refresh flow, and writes count double against the 400 per minute cap.

Tried to integrate with Help Scout?
SOURCES
Hard rate limit of 400 requests per minute per access token, and POST/PUT/DELETE/PATCH count as 2 requests each, bulk historical migrations hit 429 quickly developer.helpscout.com
Rate limit is per access token but all users on the same account share quota in practice, concurrent integrations interfere with each other github.com
Access tokens expire after 48 hours with no refresh-token mechanism for the client_credentials flow, apps must implement token re-issuance logic and cache developer.helpscout.com
List Conversations endpoint paginates at only 25 items per page (vs. 50 elsewhere), so multi-year mailbox exports take significantly longer developer.helpscout.com
Bulk export workflows commonly hit 429 when humans are simultaneously editing articles/conversations in the UI, requiring careful Retry-After handling clonepartner.com
Higher rate limits are not self-serve, depend on plan tier and require contacting Help Scout support stitchflow.com
Docs API and Inbox API are separate surfaces with separate base URLs and slightly different conventions, increasing integration surface area developer.helpscout.com
No official GraphQL endpoint or bulk-export API, large historical pulls require paginated REST plus disciplined backoff eesel.ai
Reporting and analytics are shallow out of the box; deeper insights require Pro plan or piping data to a BI tool g2.com
Workflow customization feels restrictive for complex routing and SLA scenarios compared to Zendesk/Freshdesk g2.com
Limited multichannel coverage, no native phone/voice, weaker proactive chat, and AI chatbot customization is basic vs. Intercom Fin gorgias.com
Cost scales linearly with seats and add-ons can stack quickly (extra inboxes $10/mo each, extra Docs sites $20/mo each, AI Answers $0.75/resolution) helpscout.com
Advanced features (custom roles, advanced permissions, HIPAA compliance, advanced reporting) gated to Plus and Pro tiers chatarmin.com
Periodic UI bugs and performance lag reported by long-tenured users, especially in high-volume inboxes softwarefinder.com
Beacon and chat are not full real-time engagement tools, teams needing live chat-first workflows often outgrow Help Scout tidio.com
Some reviewers report security/SSO/audit-log depth lagging enterprise-grade competitors capterra.com