Help Scout
Also an agent toolHelp Scout Mailbox API 2.0: Conversations (list/get/create/update PATCH move-assign-status-subject/delete, threads list + create reply/note/customer/chat/phone, update thread, attachment data + delete, custom fields, tags), Customers (list/get/create/update + addresses, emails, phones, chat handles, social profiles, websites, properties), Mailboxes (list/get/fields/folders), Users (list/get/me/teams), Teams (list/get/members), Tags, Workflows (list, run manual), Webhooks (CRUD), and Reports (conversations, productivity, company, email, chat, phone, docs, happiness). Base URL is static https://api.helpscout.net/v2. Auth is OAuth2 client_credentials — the runtime mints a Bearer token from https://api.helpscout.net/v2/oauth2/token (grant_type=client_credentials) using the app's client_id + client_secret. List Conversations is the polling trigger: modifiedSince timestamp cursor + page pagination over the HAL _embedded.conversations envelope. Help Scout signs webhook deliveries as base64(HMAC-SHA1(raw_body, secret)) in the X-HelpScout-Signature header with the event name in X-HelpScout-Event — this matches the generic_hmac handler (sha1/base64/raw_body), so change notifications are delivered as webhook triggers; webhook CRUD is also exposed as actions.
66 actions · 14 triggers
The Help Scout integration lets you connect Help Scout to your automations with 66 actions and 14 triggers — and every action is also a tool an AI agent can call. Examples: Get Current User, List Conversations, Get Conversation, Create Conversation, Update Conversation. No blank-canvas wiring — connect it and use it in your workflows.
Every action below is also a tool an AI agent can call — the same pack powers your workflows and your agents.
Triggers 14
Events in Help Scout that can start a workflow.
Conversation Created
Fires when a conversation is created (Help Scout event convo.created). Discriminated by the X-HelpScout-Event header. Payload is the full conversation object.
Conversation Assigned
Fires when a conversation is assigned (event convo.assigned).
Conversation Status Changed
Fires when a conversation's status changes (event convo.status).
Conversation Moved
Fires when a conversation is moved to another mailbox (event convo.moved).
Conversation Merged
Fires when a conversation is merged into another (event convo.merged).
Conversation Deleted
Fires when a conversation is deleted (event convo.deleted).
Conversation Tags Updated
Fires when a conversation's tags change (event convo.tags).
Agent Reply Created
Fires when an agent replies to a conversation (event convo.agent.reply.created).
Customer Reply Created
Fires when a customer replies to a conversation (event convo.customer.reply.created).
Note Created
Fires when an internal note is added to a conversation (event convo.note.created).
Customer Created
Fires when a customer is created (event customer.created). Payload is the full customer object.
Customer Updated
Fires when a customer is updated (event customer.updated).
Satisfaction Rating
Fires when a customer submits a satisfaction rating (event satisfaction.ratings).
New or updated Help Scout conversations (polled)
Polls GET /v2/conversations with a modifiedSince watermark on a schedule; results are in the HAL _embedded.conversations envelope, paged via page / _links.next.
Actions 66
What Zervanor can do in Help Scout.
Customers23
List Customers
List customers (GET /v2/customers). HAL _embedded.customers envelope with page pagination; supports mailbox, firstName, lastName, modifiedSince, email, query filters.
Get Customer
Get a single customer by id (GET /v2/customers/{customerId}).
Create Customer
Create a customer (POST /v2/customers).
Update Customer
Update a customer's core fields (PUT /v2/customers/{customerId}).
List Customer Address
Get a customer's address (GET /v2/customers/{customerId}/address).
Create Customer Address
Create a customer's address (POST /v2/customers/{customerId}/address).
Update Customer Address
Update a customer's address (PUT /v2/customers/{customerId}/address).
Create Customer Email
Add an email to a customer (POST /v2/customers/{customerId}/emails).
Update Customer Email
Update a customer's email (PUT /v2/customers/{customerId}/emails/{emailId}).
Delete Customer Email
Delete a customer's email (DELETE /v2/customers/{customerId}/emails/{emailId}).
Create Customer Phone
Add a phone to a customer (POST /v2/customers/{customerId}/phones).
Update Customer Phone
Update a customer's phone (PUT /v2/customers/{customerId}/phones/{phoneId}).
Delete Customer Phone
Delete a customer's phone (DELETE /v2/customers/{customerId}/phones/{phoneId}).
Create Customer Chat Handle
Add a chat handle to a customer (POST /v2/customers/{customerId}/chats).
Update Customer Chat Handle
Update a customer's chat handle (PUT /v2/customers/{customerId}/chats/{chatId}).
Delete Customer Chat Handle
Delete a customer's chat handle (DELETE /v2/customers/{customerId}/chats/{chatId}).
Create Customer Social Profile
Add a social profile to a customer (POST /v2/customers/{customerId}/social-profiles).
Update Customer Social Profile
Update a customer's social profile (PUT /v2/customers/{customerId}/social-profiles/{socialProfileId}).
Delete Customer Social Profile
Delete a customer's social profile (DELETE /v2/customers/{customerId}/social-profiles/{socialProfileId}).
Create Customer Website
Add a website to a customer (POST /v2/customers/{customerId}/websites).
Update Customer Website
Update a customer's website (PUT /v2/customers/{customerId}/websites/{websiteId}).
Delete Customer Website
Delete a customer's website (DELETE /v2/customers/{customerId}/websites/{websiteId}).
Update Customer Properties
Update a customer's property values via JSON Patch (PATCH /v2/customers/{customerId}/properties).
Conversations17
List Conversations
List conversations (GET /v2/conversations). Supports modifiedSince, status, tag, mailbox, folder filters, page pagination, and HAL _embedded.conversations + _links.next + page.totalPages. Used as the polling trigger.
Get Conversation
Get a single conversation by id (GET /v2/conversations/{conversationId}).
Create Conversation
Create a conversation (POST /v2/conversations). Requires subject, customer, mailboxId, type, status, and at least one thread.
Update Conversation
Update a conversation via JSON Patch (PATCH /v2/conversations/{conversationId}) — move mailbox/folder, assign, change status, change subject, etc. Body is a JSON Patch op { op, path, value }.
Delete Conversation
Delete a conversation (DELETE /v2/conversations/{conversationId}).
List Conversation Threads
List a conversation's threads (GET /v2/conversations/{conversationId}/threads). HAL _embedded.threads envelope.
Create Reply Thread
Add a reply thread to a conversation (POST /v2/conversations/{conversationId}/reply). A reply is sent to the customer.
Create Note Thread
Add an internal note to a conversation (POST /v2/conversations/{conversationId}/notes). Notes are not visible to customers.
Create Customer Thread
Add a customer thread to a conversation (POST /v2/conversations/{conversationId}/customer) — logs a message on behalf of the customer.
Create Chat Thread
Add a chat thread to a conversation (POST /v2/conversations/{conversationId}/chats).
Create Phone Thread
Add a phone thread to a conversation (POST /v2/conversations/{conversationId}/phones).
Update Thread
Update a thread's text (PATCH /v2/conversations/{conversationId}/threads/{threadId}). JSON Patch on /text.
Get Attachment Data
Get an attachment's binary data, base64-encoded (GET /v2/conversations/{conversationId}/attachments/{attachmentId}/data).
Delete Attachment
Delete an attachment (DELETE /v2/conversations/{conversationId}/attachments/{attachmentId}).
List Conversation Custom Fields
List a conversation's custom field values (GET /v2/conversations/{conversationId}/fields).
Update Conversation Custom Fields
Set a conversation's custom field values (PUT /v2/conversations/{conversationId}/fields).
Update Conversation Tags
Set a conversation's tags (PUT /v2/conversations/{conversationId}/tags). Replaces the full tag set.
Reports8
Conversations Report
Company conversations report (GET /v2/reports/conversations) — volume, busy times, new/replies for a date range.
Productivity Report
Productivity report (GET /v2/reports/productivity) — response/resolution/handle times over a date range.
Company Report
Company overview report (GET /v2/reports/company) — customers helped, conversations, happiness for a date range.
Email Channel Report
Email channel report (GET /v2/reports/email) — email conversation metrics for a date range.
Chat Channel Report
Chat channel report (GET /v2/reports/chat) — chat conversation metrics for a date range.
Phone Channel Report
Phone channel report (GET /v2/reports/phone) — phone conversation metrics for a date range.
Docs Report
Docs report (GET /v2/reports/docs) — knowledge-base article performance for a date range.
Happiness Report
Happiness (satisfaction ratings) report (GET /v2/reports/happiness) — great/okay/not-good ratings for a date range.
Webhooks5
List Webhooks
List webhooks (GET /v2/webhooks). HAL _embedded.webhooks envelope.
Get Webhook
Get a single webhook by id (GET /v2/webhooks/{webhookId}).
Create Webhook
Create a webhook subscription (POST /v2/webhooks). Provide the callback URL, subscribed events, and a secret used to sign deliveries.
Update Webhook
Update a webhook subscription (PUT /v2/webhooks/{webhookId}).
Delete Webhook
Delete a webhook subscription (DELETE /v2/webhooks/{webhookId}).
Mailboxes4
List Mailboxes
List mailboxes (GET /v2/mailboxes). HAL _embedded.mailboxes envelope.
Get Mailbox
Get a single mailbox by id (GET /v2/mailboxes/{mailboxId}).
List Mailbox Custom Fields
List a mailbox's custom field definitions (GET /v2/mailboxes/{mailboxId}/fields).
List Mailbox Folders
List a mailbox's folders (GET /v2/mailboxes/{mailboxId}/folders).
Teams3
List Teams
List teams (GET /v2/teams). HAL _embedded.teams envelope. Requires a Plus/Pro plan.
Get Team
Get a single team by id (GET /v2/teams/{teamId}).
List Team Members
List a team's members (GET /v2/teams/{teamId}/members).
Users3
Get Current User
Get the authenticated user (GET /v2/users/me). Identity + connectivity probe.
List Users
List users (GET /v2/users). HAL _embedded.users envelope; supports mailbox filter + page pagination.
Get User
Get a single user by id (GET /v2/users/{userId}).
Workflows2
List Workflows
List workflows (GET /v2/workflows). HAL _embedded.workflows envelope.
Run Manual Workflow
Run a manual workflow against a set of conversations (POST /v2/workflows/{workflowId}/run).
Tags1
List Tags
List tags (GET /v2/tags). HAL _embedded.tags envelope with page pagination.
Nothing matches your search.
Automations using Help Scout
Build your own automation with Help Scout in the visual builder.
Frequently asked questions
What can I automate with Help Scout?
66 actions are available — for example: Get Current User, List Conversations, Get Conversation, Create Conversation, Update Conversation, and more.
Which Help Scout events can start a workflow?
14 triggers — for example: Conversation Created, Conversation Assigned, Conversation Status Changed, Conversation Moved.
Can Help Scout be used as an AI agent tool?
Yes. Every Help Scout action automatically becomes a tool an AI agent can call — the same pack powers both your workflows and your agents.
How is the Help Scout integration modelled?
Help Scout is modelled as a versioned connector pack, and the steps that need reasoning fall to first-party agents hosted in the same runtime as the workflows.