Does Help Scout have an API, and which one do I need?
Two. The Inbox API, still called Mailbox API 2.0 in places, is a REST API at api.helpscout.net/v2 for conversations, threads, customers, tags, mailboxes, users and reports. The Docs API at docsapi.helpscout.net/v1 manages knowledge-base sites, collections and articles. The older Mailbox API 1.0 is deprecated.
Does Help Scout support webhooks and event notifications?
Yes. Events cover conversations (created, assigned, moved, merged, deleted, status, tags, custom fields, replies, notes), customers, organizations, tags, ratings, Beacon chats, survey responses and user status changes. Each request carries an X-HelpScout-Signature header so you can confirm it came from Help Scout.
Do I need a developer to use Help Scout's API?
For a simple sync through a third-party connector, often not. To react to webhooks in real time, like issuing a refund when a tag is applied, yes: something has to receive the event, verify it and act on it, and keep doing that every day. n-frames builds that receiving end and keeps it running.
Is Help Scout's API available on every plan?
No. Help Scout's docs say the Free plan doesn't include the API or integrations. Standard gets up to 200 calls a minute without the reporting endpoints, Plus up to 400 and Pro up to 800 with all endpoints. Check your plan before choosing a design that depends on reports or a high call rate.
How long does a Help Scout access token last?
Two days. Both OAuth2 flows return tokens with expires_in of 172800 seconds. When a call comes back 401, get a new token; with the authorization code flow, swap the refresh token for it.