1. Go to developer.helpscout.com > My Apps. 2. Create app with OAuth. 3. Or generate API key for basic auth (simpler).
| Base URL | https://api.helpscout.net/v2/ |
|---|---|
| API version | v2 (Mailbox 2.0) |
| Auth | OAuth 2.0 Authorization Code. Register at developer.helpscout.com. Or use API key with Basic auth. |
| Token URL | https://api.helpscout.net/v2/oauth2/token |
| Request body | application/json |
| Pagination | page-based: ?page=1 (50 per page). _embedded.conversations and page info in response. |
| Rate limit | 400 req/min per app. HTTP 429. |
| Error format | JSON: {"_embedded":{"errors":[{"path":"...","message":"..."}]}} |
| Method | Path | Description |
|---|---|---|
GET | /conversations | List conversations |
GET | /mailboxes | List mailboxes |
POST | /conversations | Create conversation |
GET | /customers | List customers |
GET /v2/conversations?status=active&mailbox=12345
Authorization: Bearer {access_token}
Source: curated by KanseiLink from official documentation (docs) and registry checks. Last reviewed: 2026-04-07. Specs change โ verify against the official docs before production use.