# Help Scout

Manage Help Scout: conversations, customers, mailboxes, threads, tags, users. Exposes **29 actions** covering the full API surface
the agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `helpscout_account_get` | Get authenticated account info - GET /account. |
| `helpscout_conversations_list` | List conversations (support tickets/threads) - GET /conversations. |
| `helpscout_conversation_get` | Get one conversation - GET /conversations/{id}. |
| `helpscout_conversation_create` | Create a new conversation - POST /conversations. |
| `helpscout_conversation_update` | Update a conversation - PATCH /conversations/{id}. |
| `helpscout_conversations_search` | Search conversations - GET /conversations/search. |
| `helpscout_conversation_merge` | Merge two conversations - POST /conversations/{id}/merge. |
| `helpscout_conversation_delete` | Delete a conversation - DELETE /conversations/{id}. |
| `helpscout_threads_list` | List threads (messages) in a conversation - GET /conversations/{conversation_id}/threads. |
| `helpscout_thread_get` | Get one thread (message) - GET /conversations/{conversation_id}/threads/{thread_id}. |
| `helpscout_thread_create_reply` | Create a reply in a conversation - POST /conversations/{conversation_id}/threads. |
| `helpscout_thread_create_note` | Create a note (internal) in a conversation - POST /conversations/{conversation_id}/threads with type=note. |
| `helpscout_customers_list` | List customers - GET /customers. |
| `helpscout_customer_get` | Get one customer - GET /customers/{id}. |
| `helpscout_customer_create` | Create a customer - POST /customers. |
| `helpscout_customer_update` | Update a customer - PATCH /customers/{id}. |
| `helpscout_customer_merge` | Merge two customers - POST /customers/{id}/merge. |
| `helpscout_customer_delete` | Delete a customer - DELETE /customers/{id}. |
| `helpscout_mailboxes_list` | List mailboxes (inboxes/support queues) - GET /mailboxes. |
| `helpscout_mailbox_get` | Get one mailbox - GET /mailboxes/{id}. |
| `helpscout_folders_list` | List folders (e.g. |
| `helpscout_tags_list` | List tags - GET /tags. |
| `helpscout_tag_create` | Create a tag - POST /tags. |
| `helpscout_users_list` | List team members/users - GET /users. |
| `helpscout_user_get` | Get one user - GET /users/{id}. |
| `helpscout_workflows_list` | List automation workflows - GET /workflows. |
| `helpscout_workflow_get` | Get one workflow - GET /workflows/{id}. |
| `helpscout_reports_conversation_stats` | Get conversation statistics/report - GET /reports/conversations. |
| `helpscout_reports_customer_stats` | Get customer statistics/report - GET /reports/customers. |

## How to get credentials

This connector uses **OAuth 2.0**. In FlyMyAI, open the tool and click
**Connect** - you'll be redirected to Help Scout to authorize, then back to
FlyMyAI. There is no API key to paste.

> The OAuth app must be registered by FlyMyAI for this provider. If you see
> *"connection not configured"*, the provider's client credentials are still
> being set up - check back shortly.

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| _(none)_ | Connect via OAuth - nothing to paste. |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the OAuth connection expired or was revoked - reconnect.
- **`429 Too Many Requests`** - you hit the provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [Help Scout API documentation](https://developer.helpscout.com/mailbox-api)