Manage Tags

List, create, update, or delete tags. Tags are used to categorize and organize conversations. Use "list" to see all tags, or create/update/delete individual tags.

Manage Organization

List, get, create, update, or delete organizations. Organizations represent companies that can be associated with multiple customers.

Get Conversation

Retrieve a single conversation with its full details and threads. Returns the conversation metadata plus all threads (replies, notes, etc.) in the conversation.

Update Customer

Update an existing customer's profile. Change their name, organization, job title, or background notes. To manage emails and phones, use the dedicated add/remove operations.

Manage Workflow

List, activate, deactivate, or manually run workflows (automation rules). Workflows automate common actions on conversations.

List Conversations

Search and list support conversations across mailboxes. Filter by mailbox, status, tag, assignee, or use a custom query string. Results are paginated.

List Teams

List all teams in the Help Scout account. Optionally retrieve the members of a specific team.

List Mailboxes

List all mailboxes (shared inboxes) in the Help Scout account. Optionally retrieve folders and custom fields for a specific mailbox.

List Satisfaction Ratings

Retrieve customer satisfaction ratings. Filter by mailbox and date range.

Add Thread

Add a reply, note, or phone thread to an existing conversation. Agent replies send actual emails to the customer. Notes are internal-only. Phone threads log phone calls.

Get Customer

Retrieve a customer's full profile including all emails, phone numbers, and other contact information.

List Customers

Search and list customer profiles. Filter by email, name, mailbox, or use a custom query. Results are paginated.

Create Customer

Create a new customer profile with contact information. At minimum provide a first name or email address.

Delete Conversation

Permanently delete a conversation. This action cannot be undone.

Update Conversation

Update an existing conversation's properties. Change status, assignee, subject, tags, or custom fields. Multiple updates can be applied at once.

Create Conversation

Create a new support conversation in a mailbox. You must specify the customer (by email or ID), the mailbox, and at least one thread (the initial message). Optionally assign it to a user, add tags, or set status.

Get Report

Retrieve reporting data from Help Scout. Choose from company overview, conversation metrics, or customer satisfaction (happiness) reports. All reports require a date range.

Manage Knowledge Base

Manage Help Scout Docs knowledge base content. List sites, collections, categories, and articles. Create, update, or delete articles and collections. Search articles. **Requires a Docs API key** configured in authentication.

List Users

List all users (agents/staff) in the Help Scout account. Optionally retrieve details for a specific user by ID or get the authenticated user's profile.