Help Scout provides customer support software with shared inbox, knowledge base, and customer management tools
Help Scout provides customer support software with shared inbox, knowledge base, and customer management tools On Nagent, Help Scout is exposed as a fully-configurable customer support integration that any agent can call — 129 actions, and OAuth authentication. No code is required to wire Help Scout into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Help Scout to automate the kinds of tasks customer support teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Help Scout into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Help Scout, with input parameters and output schema. Drop these into any step of an agent built in Helix.
HELP_SCOUT_CREATE_CHAT_HANDLETool to create a chat handle for a Help Scout customer. Use when you need to add a chat platform username (like Skype, AIM, Yahoo) to a customer's profile.
Input parameters
Chat platform type. Must be one of: aim, gtalk, icq, msn, other, qq, skype, xmpp, yahoo
The chat handle/username on the specified platform
The customer ID for whom to create the chat handle
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_CREATE_CHAT_THREADTool to create a new chat thread on a Help Scout conversation. Use when adding a chat message to an existing conversation. Note: Conversations can have a maximum of 100 threads. Non-imported threads automatically reopen closed conversations.
Input parameters
The chat message content.
Customer details. Either customer.id or customer.email must be provided.
Set to true when importing historical data. Prevents notifications from being sent. Use for bulk imports or historical data migration.
Custom creation timestamp for imported threads. ISO 8601 format. Only used when imported=true.
List of file attachments to include with the chat thread.
The ID of the conversation to create the chat thread on.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_CREATE_CONVERSATIONTool to create a new conversation in Help Scout. Use when creating email, phone, or chat conversations with customer threads.
Input parameters
Array of tag names to apply to the conversation
Conversation type: email, phone, or chat
User ID of the user who created the conversation. Only valid for imported conversations
Array of custom field objects with id and value
Conversation status: active, closed, pending, or spam
Subject line for the conversation
Array of thread objects. At least one thread is required to create a conversation
User ID to assign the conversation to
Closed date in ISO 8601 format (e.g., 2024-01-15T12:00:00Z). Only valid when status is closed
Customer object with email or id. At least one must be provided
Set to true if this is an imported conversation. When true, no notifications are sent and the conversation is marked as imported
Created date in ISO 8601 format (e.g., 2024-01-15T10:30:00Z). Only valid for imported conversations
ID of the mailbox where conversation will be created
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_CREATE_CUSTOMERTool to create a new customer in Help Scout with contact details and profile information. Use when you need to add a new customer with emails, phones, addresses, or other contact data.
Input parameters
Age or age range
Array of chat handle objects with type and value
Array of email objects with type and value. At least one email is recommended for customer identification.
Gender: male, female, or unknown
Array of phone objects with type and value
Address object with location details.
Job title (max 60 characters)
Customer's last name (1-40 characters)
URL to profile photo (max 200 characters)
Array of website URLs
Customer's first name (1-40 characters)
Background information or notes (max 200 characters)
Organization name
Array of social profile objects with type and value
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_CREATE_CUSTOMER_ADDRESSTool to create an address for a Help Scout customer. Use when you need to add a physical address to a customer's profile.
Input parameters
City of the address.
Address lines (street address, building number, etc.).
State or province of the address.
Country code of the address (typically 2-letter ISO code).
The unique identifier for the customer.
Postal code or ZIP code of the address.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_CREATE_CUSTOMER_EMAILTool to create an email for a customer in Help Scout. Use when you need to add a new email address to a customer's profile.
Input parameters
Email category - home, other, or work
Email address to add for the customer
Identifier of the customer to add the email to
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_CREATE_CUSTOMER_PHONETool to create a phone number for a Help Scout customer. Use when adding contact phone numbers to customer profiles.
Input parameters
Phone location type (fax, home, mobile, other, pager, or work)
The telephone number
The customer ID to add the phone number to
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_CREATE_CUSTOMER_PROPERTYTool to create a customer property definition in Help Scout. Use when you need to add custom fields to track additional customer information like subscription plan, tier level, or custom attributes. Maximum 50 customer property definitions per company.
Input parameters
Human-readable display name for the property
Unique identifier for the property (1-100 characters, alphanumeric with hyphens/underscores only). Cannot be 'email', 'name', 'company', or 'jobTitle' as these are reserved
Type of the property. Use 'dropdown' for predefined options, 'number' for numeric values, 'text' for free-form text, 'url' for web links, or 'date' for date values
List of dropdown options (max 100). Required when type is 'dropdown', ignored for other types. Each option must have a unique label
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_CREATE_CUSTOMER_THREADTool to create a new customer thread on a Help Scout conversation. Use when a customer needs to add a message to an existing conversation. The conversation will reopen unless imported mode is enabled. Conversations are limited to 100 threads maximum.
Input parameters
List of email addresses to CC on the thread
List of email addresses to BCC on the thread
The message text content for the thread
Customer object. Must include either id or email field
Enables historical import mode. When true, no notifications are generated and the conversation remains in its current state
Custom creation date for imports (ISO 8601 format). Only used when imported is true
Optional list of attachments to include with the thread
The ID of the conversation to add the thread to
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_CREATE_CUSTOMER_WEBSITETool to create a website entry for a customer in Help Scout. Use when adding a website URL to an existing customer profile.
Input parameters
The website URL to add to the customer profile
The ID of the customer to add the website to
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_CREATE_NOTETool to create a new note thread on a Help Scout conversation. Use when you need to add internal notes to conversations. Notes are visible only to team members, not customers. Maximum 100 threads per conversation.
Input parameters
The note text content
User ID adding the thread; defaults to resource owner if omitted
Conversation status options.
Enables thread creation for historical purposes; prevents outgoing emails/notifications when true
Historical creation date in ISO 8601 format; only usable when imported is true
Optional list of attachment objects to include with the note
The ID of the conversation to add the note to
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_CREATE_ORGANIZATIONTool to create a new organization in Help Scout. Use when you need to create a company profile with associated domains, contact information, and metadata.
Input parameters
Organization name (required)
Internal notes about the organization (visible only to team members)
Array of phone numbers associated with the organization
Array of domain strings associated with the organization
Organization website URL
Physical location of the organization
Brand color in hex format (e.g., #FF5733)
Description of the organization
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_CREATE_ORGANIZATION_PROPERTYTool to create a new custom property definition for organizations in Help Scout. Use when you need to add custom fields to track organization-specific data like industry, account tier, renewal dates, or other metadata. Maximum 50 property definitions allowed per account.
Input parameters
Human-readable display name for the property shown in the UI; maximum 100 characters
Unique logical identifier for the property within the account; must be 1-120 characters in length. Used as the property key in API calls.
Property data type. Valid values: text (plain text), number (numeric values), url (web addresses), date (date values), dropdown (selection list)
Array of dropdown choices; required when type is 'dropdown', ignored otherwise. Maximum 100 options allowed per property.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_CREATE_PHONE_THREADTool to create a new phone thread on a Help Scout conversation. Use when you need to log a phone call interaction with a customer on an existing conversation.
Input parameters
The phone conversation text describing the call details
Customer object with ID or email (at least one required)
Set to true to create a historical thread without sending notifications or reopening the conversation
Optional creation date in ISO 8601 format. Requires imported to be true
List of file attachments to include with the phone thread
The ID of the conversation to add the phone thread to
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_CREATE_REPLY_THREADTool to create a new reply thread on a Help Scout conversation. Use when sending a reply to a customer in an existing conversation. The reply can be published immediately or saved as a draft.
Input parameters
Array of CC email addresses
Array of BCC email addresses
Reply text content (HTML supported)
Help Scout user ID sending the reply
When true, creates a draft reply instead of publishing immediately. Defaults to false
Conversation status options.
User ID to assign the conversation to after publishing the reply
Customer object with id field
Set to true for historical/imported replies. Prevents outgoing emails and notifications
Historical creation date in ISO 8601 format (e.g., 2024-01-15T10:30:00Z). Only valid when imported is true
Array of attachment objects to include with the reply
ID of the conversation to reply to
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_CREATE_SAVED_REPLYTool to create a saved reply for a mailbox in Help Scout. Use when you need to create reusable message templates for email or chat responses.
Input parameters
The name of the saved reply. This is used to identify and search for the reply.
The saved reply's text content for email messages. Supports HTML formatting with tags like <br /> for line breaks.
The saved reply's text content for chat messages. Use plain text with newline characters (\\n) for line breaks instead of HTML.
The mailbox ID where the saved reply will be created. This identifies which mailbox the saved reply belongs to.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_CREATE_SOCIAL_PROFILETool to create a social profile for a customer in Help Scout. Use when you need to add social media profile information (LinkedIn, Twitter, Facebook, etc.) to a customer record.
Input parameters
The type of social profile (e.g., linkedin, twitter, facebook, instagram, youtube, pinterest, github, or other).
The social profile URL or handle. For URLs, provide the full URL (e.g., 'https://linkedin.com/in/testuser123'). For handles, provide the username.
The unique identifier of the customer to add the social profile to.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_CREATE_WEBHOOKTool to create a new webhook subscription in Help Scout to receive real-time event notifications. Use when setting up webhook integrations to track conversations, customers, tags, or other events.
Input parameters
The callback URL where webhook events will be sent
Label to identify the webhook
Webhook state.
Array of event names to subscribe to for webhook notifications
Secret key for webhook signature verification (max 40 characters)
Array of mailbox IDs to scope webhook to specific mailboxes. If omitted, webhook applies to all mailboxes
If true, sends only resource URI instead of full payload
Webhook payload version.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_DELETE_CHAT_HANDLETool to delete a chat handle for a customer. Use when you need to remove a chat handle associated with a customer account.
Input parameters
The unique identifier for the chat handle to be deleted
The unique identifier for the customer
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_DELETE_CONVERSATIONTool to move a conversation to the deleted folder. Use when you need to delete a conversation. The conversation can only be restored by a Help Scout administrator.
Input parameters
The unique identifier of the conversation to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_DELETE_CUSTOMERTool to permanently delete a customer by ID from Help Scout. This hard-deletes the customer including microsurvey responses and conversations (irreversible, GDPR compliant). Returns 403 if user lacks access to all conversations or customer has >100 conversations.
Input parameters
The customer identifier to delete. This will permanently delete the customer including microsurvey responses and conversations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_DELETE_CUSTOMER_ADDRESSTool to delete a customer's address from Help Scout. Use when you need to remove address information associated with a specific customer account.
Input parameters
The unique identifier for the customer whose address should be removed
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_DELETE_CUSTOMER_EMAILTool to delete an email for a customer. Use when you need to remove a customer's email address from Help Scout.
Input parameters
The email identifier to delete
The customer identifier
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_DELETE_CUSTOMER_PHONETool to delete a customer's phone number from Help Scout. Use when you need to remove a phone number associated with a specific customer account.
Input parameters
The unique identifier for the phone number to delete
The unique identifier for the customer whose phone should be removed
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_DELETE_CUSTOMER_PROPERTYTool to perform a soft delete on a customer property definition. The property is scheduled for permanent deletion, with its slug temporarily reassigned during the grace period.
Input parameters
The unique identifier (slug) for the customer property to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_DELETE_CUSTOMER_WEBSITETool to delete a website for a customer. Use when you need to remove a website from a customer record.
Input parameters
The unique identifier for the website to be deleted
The unique identifier for the customer
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_DELETE_ORGANIZATIONTool to delete an organization by ID. Use when removing an organization from Help Scout. This operation also removes the reference to this organization from all associated customers.
Input parameters
The organization's unique identifier to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_DELETE_ORGANIZATION_PROPERTY_CUSTOMER_TIERTool to delete a customer tier property definition from organizations. This performs a soft-delete, and the property will be removed permanently after a grace period. Use when you need to remove a custom organization property definition.
Input parameters
The property definition identifier slug. Use 'customer-tier' to delete the customer tier property.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_DELETE_SAVED_REPLYTool to delete a saved reply from a mailbox. Use when you need to permanently remove a saved reply. Returns 204 No Content on successful deletion.
Input parameters
The unique identifier for the mailbox containing the saved reply to delete.
The unique identifier for the saved reply to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_DELETE_SNOOZETool to delete a snooze on a conversation. Use when you need to remove a snooze from a conversation, which will place it into its new home folder (Mine, Team or Unassigned, based on assignee).
Input parameters
The unique identifier of the conversation to remove the snooze from
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_DELETE_SOCIAL_PROFILETool to delete a social profile for a customer in Help Scout. Use when you need to remove a social media profile link from a customer record.
Input parameters
The unique identifier of the customer who owns the social profile.
The unique identifier of the social profile to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_DELETE_THREAD_SCHEDULETool to unschedule a scheduled thread in a conversation. Use when you need to convert a scheduled thread to a draft thread. The scheduled thread will be converted to a standard draft thread.
Input parameters
The unique identifier of the thread to unschedule
The unique identifier of the conversation containing the thread
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_DELETE_WEBHOOKTool to permanently delete a webhook subscription from Help Scout. Use when you need to remove webhook integrations that are no longer needed.
Input parameters
The unique identifier of the webhook to delete
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_DOWNLOAD_ATTACHMENTTool to download an attachment file from a Help Scout conversation. Use when you need to retrieve the actual file content of an attachment.
Input parameters
The unique identifier of the attachment file to download
The unique identifier of the conversation containing the attachment
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_ATTACHMENT_DATATool to retrieve attachment data for a specific attachment. Returns base64-encoded attachment content.
Input parameters
The unique identifier of the attachment to retrieve
The unique identifier of the conversation containing the attachment
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_BUSY_TIMES_REPORTTool to get busiest time of day report showing conversation volume by day and hour. Use when you need to analyze conversation patterns to identify peak support hours or optimize team scheduling. Requires Plus or Pro plan.
Input parameters
End date in ISO 8601 format. Example: '2024-01-31T23:59:59Z'
Comma-separated list of tag IDs to filter by. Example: '10,20,30'
Start date in ISO 8601 format. Example: '2024-01-01T00:00:00Z'
Comma-separated list of conversation types to filter by. Allowed values: 'email', 'chat', 'phone'
Comma-separated list of folder IDs to filter by. Example: '100,200'
Comma-separated list of mailbox IDs to filter by. Example: '1,2,3'
Previous period end date for comparison in ISO 8601 format. Example: '2023-12-31T23:59:59Z'
Previous period start date for comparison in ISO 8601 format. Example: '2023-12-01T00:00:00Z'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_CHAT_REPORTTool to retrieve comprehensive chat report statistics from Help Scout. Use when you need to analyze chat performance metrics including conversation volume, wait times, response times, message counts, and chat durations. Supports period-over-period comparisons and filtering by mailboxes, tags, or folders. Note: Only available to Plus and Pro plans.
Input parameters
End of the interval in ISO 8601 format (e.g., '2024-01-31T23:59:59Z'). Required parameter.
Comma-separated list of tag IDs to filter the report. Example: '99787' or '5666,99787'.
Start of the interval in ISO 8601 format (e.g., '2024-01-01T00:00:00Z'). Required parameter.
Comma-separated list of folder IDs to filter the report. Example: '991' or '991,992'.
Comma-separated list of mailbox/inbox IDs to filter the report. Example: '123' or '123,567'.
Whether to take office hours into consideration in the report calculations. Defaults to false if not specified.
End of the previous interval in ISO 8601 format for comparison. If provided, previousStart must also be specified.
Start of the previous interval in ISO 8601 format for comparison. If provided, previousEnd must also be specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_COMPANY_CUSTOMERS_HELPED_REPORTTool to retrieve company customers helped report showing distinct customer count receiving support. Use when you need to analyze how many unique customers were helped during a specific period, compare periods, or track customer engagement trends. Available only for Plus and Pro plans.
Input parameters
Conclusion of current time interval in ISO 8601 format. Example: '2024-01-31T23:59:59Z'
Comma-separated list of tag IDs for filtering. Example: '111,222,333'
Beginning of current time interval in ISO 8601 format. Example: '2024-01-01T00:00:00Z'
Types of conversations supported by Help Scout.
Data resolution options for viewing report data.
Comma-separated list of folder IDs for filtering. Example: '10,20,30'
Comma-separated list of mailbox/inbox IDs for filtering. Example: '123,456,789'
Conclusion of comparison period in ISO 8601 format. If provided, previousStart must also be provided.
Beginning of comparison period in ISO 8601 format. If provided, previousEnd must also be provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_COMPANY_DRILLDOWN_REPORTTool to retrieve company drilldown report showing underlying conversation data for company statistics. Use when you need to analyze conversations by various dimensions like reply counts, response times, or resolution metrics. Available only for Plus and Pro plans.
Input parameters
End of the interval in ISO 8601 format. Example: '2024-01-31T23:59:59Z'
Page number for pagination. Default is 1.
Results per page. Default is 25, maximum is 50.
Comma-separated tag IDs to filter results. Example: '100,200'
Filter dimension for drill-down: replies, firstReplyResolved, resolved, responseTime, firstResponseTime, or handleTime. Required.
Start of the interval in ISO 8601 format. Example: '2024-01-01T00:00:00Z'
Conversation type values.
Comma-separated folder IDs to filter results. Example: '10,20'
Specific range bucket ID (1-10 depending on range type)
Comma-separated inbox IDs to filter results. Example: '123,456'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_COMPANY_REPORTTool to retrieve overall company performance report from Help Scout. Returns metrics like customers helped, conversations closed, total replies, and per-user statistics for a specified time period. Use when you need to analyze team performance, track support metrics, or generate reports on customer service activity.
Input parameters
End of the reporting interval in ISO 8601 format (e.g., '2024-01-31T23:59:59Z'). Required.
Comma-separated list of tag IDs to filter the report. Optional.
Start of the reporting interval in ISO 8601 format (e.g., '2024-01-01T00:00:00Z'). Required.
Comma-separated list of conversation types to filter the report. Valid values: email, chat, phone. Optional.
Comma-separated list of folder IDs to filter the report. Optional.
Comma-separated list of inbox IDs to filter the report. Optional.
End of the previous interval in ISO 8601 format for comparison metrics. Optional.
Start of the previous interval in ISO 8601 format for comparison metrics. Optional.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_CONVERSATIONTool to retrieve a specific conversation by ID from Help Scout. Use when you need detailed information about a conversation including assignee, customer, tags, custom fields, and optionally embedded threads.
Input parameters
Allows loading sub-entities. Valid value: 'threads' to include conversation threads in the response
Unique identifier for the conversation
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_CONVERSATIONS_DRILLDOWNTool to get conversations drilldown report from Help Scout. Use when you need detailed conversation data for a specific time period. Available on Plus and Pro plans only.
Input parameters
End of the reporting interval in ISO 8601 format
Page number for pagination (default: 1)
Number of results per page (default: 25, max: 50)
Comma-separated list of tag IDs to filter by
Beginning of the reporting interval in ISO 8601 format
Conversation type options.
Comma-separated list of folder IDs to filter by
Comma-separated list of mailbox IDs to filter by
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_CONVERSATIONS_FIELD_DRILLDOWNTool to get conversations drilldown by field report from Help Scout. Use when you need to analyze conversations by specific tags, saved replies, workflows, or customers for a time period.
Input parameters
End of the reporting interval in ISO 8601 format
Page number for pagination (default: 1)
Number of results per page (default: 25, maximum: 50)
Comma-separated tag IDs to filter results
Field category to analyze; determines drill-down focus (tagid, replyid, workflowid, or customerid)
Beginning of the reporting interval in ISO 8601 format
Comma-separated conversation types to filter by. Valid values: email, chat, phone
Specific identifier for the tag, reply, workflow, or customer to drill down into
Comma-separated folder IDs to filter results
Comma-separated inbox IDs to filter results
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_CONVERSATIONS_REPORTTool to get overall conversations report with statistics on conversation volume, channels, and trends. Use when you need insights on conversation patterns, busiest times, top customers, tags, or custom field analytics. Supports optional previous period comparison for trend analysis.
Input parameters
End date in ISO 8601 format. Example: '2024-01-31T23:59:59Z'
Comma-separated list of tag IDs to filter by. Example: '10,20,30'
Start date in ISO 8601 format. Example: '2024-01-01T00:00:00Z'
Comma-separated list of conversation types to filter by. Example: 'email,chat,phone'
Comma-separated list of folder IDs to filter by. Example: '100,200'
Comma-separated list of mailbox IDs to filter by. Example: '1,2,3'
Filter by office hours. Set to true to include only conversations during office hours, false for outside office hours.
Previous period end date for comparison in ISO 8601 format. Example: '2023-12-31T23:59:59Z'
Previous period start date for comparison in ISO 8601 format. Example: '2023-12-01T00:00:00Z'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_CUSTOMERTool to get a specific customer by ID from Help Scout. Use when you need to retrieve detailed customer information including contact details, profile data, and conversation history.
Input parameters
Unique customer identifier to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_CUSTOMER_ADDRESSTool to retrieve a customer's address from Help Scout. Use when you need to fetch the physical address associated with a specific customer account.
Input parameters
The unique identifier for the customer whose address should be retrieved.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_DOCS_REPORTTool to retrieve overall docs performance report from Help Scout. Returns metrics like unique visitors, browse and search actions, popular searches, top articles, and top categories for a specified time period. Use when you need to analyze documentation usage, track knowledge base effectiveness, or identify popular content.
Input parameters
End of the reporting interval in ISO 8601 format (e.g., '2024-01-31T23:59:59Z'). Required.
Comma-separated list of docs site IDs to filter the report. Optional.
Start of the reporting interval in ISO 8601 format (e.g., '2024-01-01T00:00:00Z'). Required.
End of the previous interval in ISO 8601 format for comparison metrics. Optional.
Start of the previous interval in ISO 8601 format for comparison metrics. Optional.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_EMAIL_REPORTTool to retrieve email report with volume, resolution, and response metrics from Help Scout. Returns statistics like email conversations, response times, resolution rates, and time distributions for a specified period. Use when you need detailed email performance analytics or trend comparisons.
Input parameters
End of the interval in ISO 8601 format. Example: '2024-01-31T23:59:59Z'
Comma-separated list of tag IDs to filter the report. Example: '10,20,30'
Start of the interval in ISO 8601 format. Example: '2024-01-01T00:00:00Z'
Comma-separated list of folder IDs to filter the report. Example: '100,200'
Comma-separated list of inbox IDs to filter the report. Example: '1,2,3'
Incorporates business hours if enabled. Defaults to false. Set to true to include only emails during office hours.
Conclusion timeframe for comparison analytics in ISO 8601 format. Example: '2023-12-31T23:59:59Z'
Beginning timeframe for comparison analytics in ISO 8601 format. Example: '2023-12-01T00:00:00Z'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_FIRST_RESPONSE_TIME_REPORTTool to retrieve first response time productivity report showing average response duration. Use when you need to analyze team response performance, track response time trends, or compare response times across different periods. Available only for Plus and Pro plans.
Input parameters
End of the interval in ISO 8601 format. Example: '2024-01-31T23:59:59Z'
Comma-separated list of tag IDs to filter results. Example: '10,20,30'
Start of the interval in ISO 8601 format. Example: '2024-01-01T00:00:00Z'
Comma-separated list of conversation types to filter results. Valid values: email, chat, phone. Example: 'email,chat'
Data resolution options for viewing report data.
Comma-separated list of folder IDs to filter results. Example: '100,200'
Comma-separated list of inbox IDs to filter results. Example: '123,456,789'
Whether to take office hours into consideration. Set to true to filter by office hours. Office hours must be enabled to use this filter.
End of the previous interval in ISO 8601 format for comparison. Example: '2023-12-31T23:59:59Z'
Start of the previous interval in ISO 8601 format for comparison. Example: '2023-12-01T00:00:00Z'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_HAPPINESS_RATINGS_REPORTTool to retrieve happiness ratings report with customer satisfaction scores and feedback from Help Scout. Returns paginated list of ratings including conversation details, rating scores (Great/OK/Not Good), customer comments, and associated agent information. Use when you need to analyze customer satisfaction metrics or gather feedback data.
Input parameters
End of the reporting interval in ISO 8601 format. Example: '2024-01-31T23:59:59Z'
Page number for pagination. Use to retrieve subsequent pages of results.
Comma-separated list of tag IDs to filter the report. Example: '5666,99787'
Start of the reporting interval in ISO 8601 format. Example: '2024-01-01T00:00:00Z'
Comma-separated list of conversation types to filter by. Valid values: email, chat, phone. Example: 'email,chat'
Enumeration for rating filter options.
Comma-separated list of folder IDs to filter the report. Example: '100,200'
Comma-separated list of mailbox IDs to filter the report. Example: '123,567'
Enumeration for sort field options.
Enumeration for sort order options.
Prior interval end for comparison purposes in ISO 8601 format. Example: '2023-12-31T23:59:59Z'
Prior interval start for comparison purposes in ISO 8601 format. Example: '2023-12-01T00:00:00Z'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_HAPPINESS_REPORTTool to retrieve overall happiness report from Help Scout. Returns customer satisfaction metrics including ratings percentages, counts, and happiness scores for a specified time period. Use when you need to analyze customer satisfaction trends, track happiness scores, or generate reports on customer feedback.
Input parameters
End of the interval in ISO 8601 format (e.g., '2024-01-31T23:59:59Z'). Optional.
Comma-separated list of tag IDs to filter the report. Optional.
Start of the interval in ISO 8601 format (e.g., '2024-01-01T00:00:00Z'). Optional.
Comma-separated list of conversation types to filter the report. Valid values: email, chat, phone. Optional.
Comma-separated list of folder IDs to filter the report. Optional.
Comma-separated list of inbox IDs to filter the report. Optional.
Conclusion point for prior period comparison in ISO 8601 format. Optional.
Beginning point for prior period comparison in ISO 8601 format. Optional.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_INBOXTool to retrieve a specific inbox by ID with details including name, email, and timestamps. Use when you need to get information about a particular mailbox or inbox.
Input parameters
Unique identifier for the inbox to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_NEW_CONVERSATIONS_DRILLDOWNTool to get new conversations drilldown report showing underlying conversation data for new conversations created within a time period. Use when you need to analyze newly created conversations with detailed information. Available only for Plus and Pro plans.
Input parameters
End of the interval in ISO 8601 format. Example: '2024-01-31T23:59:59Z'
Page number for pagination. Default is 1.
Results per page. Default is 25, maximum is 50.
Comma-separated tag IDs to filter results. Example: '100,200'
Start of the interval in ISO 8601 format. Example: '2024-01-01T00:00:00Z'
Comma-separated conversation types to filter by. Valid values: email, chat, phone
Comma-separated folder IDs to filter results. Example: '10,20'
Comma-separated inbox IDs to filter results. Example: '123,456'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_NEW_CONVERSATIONS_REPORTTool to get new conversations report showing conversation counts over time intervals. Use when you need to analyze new conversation trends, compare time periods, or track conversation volume patterns.
Input parameters
End of the time interval in ISO 8601 format. Example: '2024-01-31T23:59:59Z'
Comma-separated tag IDs to filter results. Example: '10,20,30'
Start of the time interval in ISO 8601 format. Example: '2024-01-01T00:00:00Z'
Types of conversations supported by Help Scout.
Data resolution options for viewing report data.
Comma-separated folder IDs to filter results. Example: '100,200'
Comma-separated inbox IDs to filter results. Example: '123,456'
Ending of prior comparison period in ISO 8601 format. Example: '2023-12-31T23:59:59Z'
Beginning of prior comparison period in ISO 8601 format. Example: '2023-12-01T00:00:00Z'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_ORGANIZATIONTool to retrieve a specific organization by ID from Help Scout. Use when you need to fetch details about an organization including name, website, domains, and contact information.
Input parameters
Whether to include customer and conversation counts in the response.
The unique identifier for the organization to retrieve.
Whether to include organization property values in the response.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_ORGANIZATION_CONVERSATIONSTool to get conversations associated with an organization in Help Scout. Use when you need to retrieve all conversations linked to a specific organization. Returns paginated results with HAL+JSON format.
Input parameters
Page number for pagination (starts at 1)
The organization ID for retrieving associated conversations
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_ORGANIZATION_CUSTOMERSTool to get customers associated with an organization in Help Scout. Use when you need to retrieve a list of all customers belonging to a specific organization. Returns paginated results with 50 customers per page.
Input parameters
Page number for pagination (1-based indexing)
The organization identifier
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_ORGANIZATION_PROPERTYTool to retrieve a single organization property definition by its slug identifier. Use when you need to get details about a specific custom property configured for organizations, including its type, display name, and available options.
Input parameters
Property definition's unique slug identifier. This is the key used to identify the property in the API.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_PHONE_REPORTTool to retrieve phone report statistics from Help Scout. Returns metrics like phone conversations, phone calls created, and customer counts for a specified period. Use when you need to analyze phone support performance or track phone activity trends. Note: Only available to Plus and Pro plans.
Input parameters
End of the interval in ISO 8601 format (e.g., '2024-01-31T23:59:59Z'). Required parameter.
Comma-separated list of tag IDs to filter the report. Example: '99787' or '5666,99787'.
Start of the interval in ISO 8601 format (e.g., '2024-01-01T00:00:00Z'). Required parameter.
Comma-separated list of folder IDs to filter the report. Example: '991' or '991,992'.
Comma-separated list of mailbox/inbox IDs to filter the report. Example: '123' or '123,567'.
Whether to take office hours into consideration in the report calculations. Defaults to false if not specified.
End of the previous interval in ISO 8601 format for comparison. If provided, previousStart must also be specified.
Start of the previous interval in ISO 8601 format for comparison. If provided, previousEnd must also be specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_PRODUCTIVITY_REPORTTool to retrieve productivity overall report showing comprehensive team performance metrics. Use when you need to analyze productivity statistics including response times, resolution times, handle times, and conversation volumes. Available only for Plus and Pro plans.
Input parameters
End of the interval in ISO 8601 format. Example: '2024-01-31T23:59:59Z'
Comma-separated list of tag IDs to filter results. Example: '10,20,30'
Start of the interval in ISO 8601 format. Example: '2024-01-01T00:00:00Z'
Comma-separated list of conversation types to filter results. Valid values: email, chat, phone. Example: 'email,chat'
Comma-separated list of folder IDs to filter results. Example: '100,200'
Comma-separated list of inbox IDs to filter results. Example: '123,456,789'
Whether to take office hours into consideration. Set to true to filter by office hours. Office hours must be enabled to use this filter.
End of the previous interval in ISO 8601 format for comparison. Example: '2023-12-31T23:59:59Z'
Start of the previous interval in ISO 8601 format for comparison. Example: '2023-12-01T00:00:00Z'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_RECEIVED_MESSAGES_REPORTTool to retrieve received messages statistics report from Help Scout. Returns count of customer-originated messages over time, broken down by day, week, or month. Use when you need to analyze incoming message volume trends or compare message counts across different time periods.
Input parameters
End of the reporting interval in ISO 8601 format (e.g., '2024-01-31T23:59:59Z'). Required.
Comma-separated list of tag IDs to filter the report. Optional.
Start of the reporting interval in ISO 8601 format (e.g., '2024-01-01T00:00:00Z'). Required.
Comma-separated list of conversation types to filter the report. Valid values: email, chat, phone. Optional.
Enumeration for data resolution view types.
Comma-separated list of folder IDs to filter the report. Optional.
Comma-separated list of inbox IDs to filter the report. Optional.
End of the previous interval in ISO 8601 format for comparison metrics. Optional.
Start of the previous interval in ISO 8601 format for comparison metrics. Optional.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_REPLIES_SENT_REPORTTool to get replies sent productivity report showing reply volume metrics over time. Use when you need to analyze reply activity trends, compare periods, or track team productivity. Requires Plus or Pro plan.
Input parameters
End date in ISO 8601 format. Example: '2024-01-31T23:59:59Z'
Comma-separated list of tag IDs to filter by. Example: '5666,99787'
Start date in ISO 8601 format. Example: '2024-01-01T00:00:00Z'
Comma-separated list of conversation types to filter by. Allowed values: 'email', 'chat', 'phone'
Data granularity for the report. Allowed values: 'day' (for periods ≤60 days), 'week' (for periods ≤1 year), 'month' (for periods ≥61 days)
Comma-separated list of folder IDs to filter by. Example: '991,992'
Comma-separated list of mailbox IDs to filter by. Example: '123,567'
Apply office hours consideration. Set to true to include only replies during office hours, false for outside office hours.
Previous period end date for comparison in ISO 8601 format. Example: '2023-12-31T23:59:59Z'
Previous period start date for comparison in ISO 8601 format. Example: '2023-12-01T00:00:00Z'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_RESOLUTION_TIME_REPORTTool to retrieve resolution time productivity report showing average time to resolve conversations. Use when you need to analyze team resolution performance, track resolution time trends, or compare resolution times across different periods. Available only for Plus and Pro plans.
Input parameters
End of the interval in ISO 8601 format. Example: '2024-01-31T23:59:59Z'
Comma-separated list of tag IDs to filter results. Example: '10,20,30'
Start of the interval in ISO 8601 format. Example: '2024-01-01T00:00:00Z'
Comma-separated list of conversation types to filter results. Valid values: email, chat, phone. Example: 'email,chat'
Data resolution options for viewing report data.
Comma-separated list of folder IDs to filter results. Example: '100,200'
Comma-separated list of inbox IDs to filter results. Example: '123,456,789'
Whether to take office hours into consideration. Set to true to filter by office hours. Office hours must be enabled to use this filter.
End of the previous interval in ISO 8601 format for comparison. Example: '2023-12-31T23:59:59Z'
Start of the previous interval in ISO 8601 format for comparison. Example: '2023-12-01T00:00:00Z'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_RESOLVED_REPORTTool to retrieve productivity resolved report from Help Scout. Returns the number of resolved conversations over time for a specified period. Use when you need to analyze team productivity, track resolution rates, or generate reports on conversation closures.
Input parameters
End of the interval in ISO 8601 format (e.g., '2024-01-31T23:59:59Z'). Required.
Comma-separated list of tag IDs to filter the report. Optional.
Start of the interval in ISO 8601 format (e.g., '2024-01-01T00:00:00Z'). Required.
Comma-separated list of conversation types to filter the report. Valid values: email, chat, phone. Optional.
Data granularity for the report. Valid values: 'day' (for periods up to 60 days), 'week' (for periods up to 1 year), 'month' (for periods of 61 days or more). Optional.
Comma-separated list of folder IDs to filter the report. Optional.
Comma-separated list of inbox IDs to filter the report. Optional.
Whether to apply office hours calculations. Defaults to false if not provided. Optional.
Conclusion point for prior period comparison in ISO 8601 format. Optional.
Beginning point for prior period comparison in ISO 8601 format. Optional.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_RESOURCE_OWNERTool to get the authenticated user's profile information. Use when you need to retrieve details about the current user.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_ROUTING_CONFIGTool to retrieve routing configuration for a mailbox inbox. Use when you need to check assignment settings, rotation status, or user eligibility for receiving conversations.
Input parameters
Unique identifier for the mailbox to retrieve routing configuration
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_SAVED_REPLYTool to retrieve a specific saved reply from a mailbox. Use when you need to get details about a saved reply template including its text content for email and chat.
Input parameters
The mailbox identifier containing the saved reply.
The unique identifier for the saved reply to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_TAGTool to retrieve a specific tag by ID from Help Scout. Use when you need to get details about a tag including its name, slug, and color.
Input parameters
The unique identifier for the tag to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_USERTool to retrieve a specific user by ID from Help Scout. Use when you need detailed information about a user including their role, contact details, and profile data.
Input parameters
Unique identifier for the user to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_USER_CHAT_REPORTTool to retrieve user/team chat report statistics from Help Scout. Returns metrics like new conversations, messages per chat, response time, wait time, and duration for a specified period. Use when you need to analyze chat support performance or track chat activity trends for a specific user or team.
Input parameters
End of the interval in ISO 8601 format (e.g., '2024-01-31T23:59:59Z'). Required parameter.
Comma-separated list of tag IDs to filter the report. Example: '99787' or '5666,99787'.
User ID for whom the report is generated. Required.
Start of the interval in ISO 8601 format (e.g., '2024-01-01T00:00:00Z'). Required parameter.
Comma-separated list of mailbox/inbox IDs to filter the report. Example: '123' or '123,567'.
Whether to take office hours into consideration in the report calculations. Defaults to false if not specified.
End of the previous interval in ISO 8601 format for comparison. If provided, previousStart must also be specified.
Start of the previous interval in ISO 8601 format for comparison. If provided, previousEnd must also be specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_USER_CONVERSATION_HISTORYTool to retrieve detailed conversation history for a specific user over a designated timeframe. Use when you need to analyze a user's conversation performance, track response times, or review conversation details. Available only for Plus and Pro plans.
Input parameters
End of the reporting interval in ISO 8601 format. Example: '2024-01-31T23:59:59Z'. Required.
Page number for pagination. Default is 1.
Comma-separated list of tag IDs to filter results. Example: '10,20,30'
Identifier for the user generating the report. Required.
Start of the reporting interval in ISO 8601 format. Example: '2024-01-01T00:00:00Z'. Required.
Comma-separated list of conversation types to filter results. Valid values: email, chat, phone. Example: 'email,chat'
Status filter options for conversation history.
Comma-separated list of folder IDs to filter results. Example: '100,200'
Comma-separated list of inbox IDs to filter results. Example: '123,456,789'
Sort field options for conversation history.
Sort order options.
Apply office hours calculation. Set to true to include only conversations during office hours, false for outside office hours.
End of the previous interval in ISO 8601 format for comparison. Example: '2023-12-31T23:59:59Z'
Start of the previous interval in ISO 8601 format for comparison. Example: '2023-12-01T00:00:00Z'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_USER_CUSTOMERS_HELPED_REPORTTool to retrieve user customers helped report showing distinct customer count receiving support from a specific user. Use when you need to analyze how many unique customers were helped by an individual team member during a specific period, compare periods, or track user performance. Available only for Plus and Pro plans.
Input parameters
Conclusion of the time interval in ISO 8601 format. Example: '2026-03-09T23:59:59Z'. Required.
Comma-separated list of tag IDs for filtering. Example: '111,222,333'
User ID for whom the report is generated. Required.
Beginning of the time interval in ISO 8601 format. Example: '2026-02-07T00:00:00Z'. Required.
Comma-separated list of conversation types to filter the report. Valid values: email, chat, phone.
Data resolution options for viewing report data.
Comma-separated list of folder IDs for filtering. Example: '10,20,30'
Comma-separated list of mailbox/inbox IDs for filtering. Example: '123,456,789'
Conclusion of comparison period in ISO 8601 format. If provided, previousStart must also be provided.
Beginning of comparison period in ISO 8601 format. If provided, previousEnd must also be provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_USER_DRILLDOWNTool to get user drilldown report from Help Scout. Use when you need detailed conversation data for a specific user within a time period. Available only for Plus and Pro plans.
Input parameters
End of the interval in ISO 8601 format
Page number for pagination (default: 1)
Number of results per page (default: 25, max: 50)
Comma-separated list of tag IDs to filter results
User ID for whom the report is generated
Start of the interval in ISO 8601 format
Comma-separated list of conversation types to filter results. Valid values: email, chat, phone
Comma-separated list of folder IDs to filter results
Comma-separated list of inbox IDs to filter results
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_USER_HAPPINESS_REPORTTool to retrieve user happiness report from Help Scout. Returns customer satisfaction metrics for a specific user including ratings percentages, counts, and happiness scores for a specified time period. Use when you need to analyze individual user performance on customer satisfaction.
Input parameters
End of the interval in ISO 8601 format. Example: '2024-01-31T23:59:59Z'. Required.
Comma-separated list of tag IDs to filter results. Example: '10,20,30'
User ID for whom the report is generated. Required.
Start of the interval in ISO 8601 format. Example: '2024-01-01T00:00:00Z'. Required.
Comma-separated list of conversation types to filter results. Valid values: email, chat, phone. Example: 'email,chat'
Comma-separated list of folder IDs to filter results. Example: '100,200'
Comma-separated list of inbox IDs to filter results. Example: '123,456,789'
End of the previous interval in ISO 8601 format for comparison. Example: '2023-12-31T23:59:59Z'
Start of the previous interval in ISO 8601 format for comparison. Example: '2023-12-01T00:00:00Z'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_USER_RATINGS_REPORTTool to retrieve user happiness ratings drilldown report showing customer satisfaction ratings for a specific user. Use when you need to analyze customer feedback, track happiness scores, or review rating comments for an individual support team member. Available only for Plus and Pro plans.
Input parameters
End of the interval in ISO 8601 format. Example: '2024-01-31T23:59:59Z'. Required.
Page number for pagination. Default is 1.
Comma-separated list of tag IDs to filter results. Example: '10,20,30'
User ID for whom the report is generated. Required.
Start of the interval in ISO 8601 format. Example: '2024-01-01T00:00:00Z'. Required.
Comma-separated list of conversation types to filter results. Valid values: email, chat, phone. Example: 'email,chat'
Rating filter options.
Comma-separated list of folder IDs to filter results. Example: '100,200'
Comma-separated list of inbox IDs to filter results. Example: '123,456,789'
Sort field options for user ratings report.
Sort order options.
End of the previous interval in ISO 8601 format for comparison. Example: '2023-12-31T23:59:59Z'
Start of the previous interval in ISO 8601 format for comparison. Example: '2023-12-01T00:00:00Z'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_USER_REPLIES_REPORTTool to retrieve user replies report showing the number of replies sent by a specific user over time. Use when you need to analyze reply volume, track user productivity, or compare reply patterns across different time periods. Available only for Plus and Pro plans.
Input parameters
End of the interval in ISO 8601 format. Example: '2024-01-31T23:59:59Z'. Required.
Comma-separated list of tag IDs to filter results. Example: '10,20,30'. Optional.
User ID for whom the report is generated. Required.
Start of the interval in ISO 8601 format. Example: '2024-01-01T00:00:00Z'. Required.
Comma-separated list of conversation types to filter results. Valid values: email, chat, phone. Example: 'email,chat'. Optional.
Data resolution options for user replies report.
Comma-separated list of folder IDs to filter results. Example: '100,200'. Optional.
Comma-separated list of inbox IDs to filter results. Example: '123,456,789'. Optional.
End of the previous interval in ISO 8601 format for comparison. Example: '2023-12-31T23:59:59Z'. Optional.
Start of the previous interval in ISO 8601 format for comparison. Example: '2023-12-01T00:00:00Z'. Optional.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_USER_REPORTTool to retrieve overall user/team performance report from Help Scout. Returns detailed metrics including conversations resolved, response time, happiness score, and customer interactions for a specific user. Use when analyzing individual team member performance or generating user-specific reports. Available only for Plus and Pro plans.
Input parameters
End of the reporting interval in ISO 8601 format (e.g., '2024-01-31T23:59:59Z'). Required.
Comma-separated list of tag IDs to filter the report. Optional.
User ID for whom the report is generated. Required.
Start of the reporting interval in ISO 8601 format (e.g., '2024-01-01T00:00:00Z'). Required.
Comma-separated list of conversation types to filter the report. Valid values: email, chat, phone. Optional.
Comma-separated list of folder IDs to filter the report. Optional.
Comma-separated list of inbox IDs to filter the report. Optional.
Whether to consider office hours in the report. Defaults to false if not provided. Optional.
End of the previous interval in ISO 8601 format for comparison metrics. Optional.
Start of the previous interval in ISO 8601 format for comparison metrics. Optional.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_USER_RESOLUTIONS_REPORTTool to retrieve user resolutions report showing the number of conversations resolved by a specific user over time. Use when you need to analyze resolution trends, track individual performance, or compare resolution rates across different time periods. Available only for Plus and Pro plans.
Input parameters
End of the interval in ISO 8601 format. Example: '2024-01-31T23:59:59Z'. Required.
Comma-separated list of tag IDs to filter results. Example: '10,20,30'
User ID for whom the report is generated. Required.
Start of the interval in ISO 8601 format. Example: '2024-01-01T00:00:00Z'. Required.
Comma-separated list of conversation types to filter results. Valid values: email, chat, phone. Example: 'email,chat'
Granularity options for viewing resolution data.
Comma-separated list of folder IDs to filter results. Example: '100,200'
Comma-separated list of inbox IDs to filter results. Example: '123,456,789'
End of the previous interval in ISO 8601 format for comparison. Example: '2023-12-31T23:59:59Z'
Start of the previous interval in ISO 8601 format for comparison. Example: '2023-12-01T00:00:00Z'
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_USER_STATUSTool to get the status of a user in Help Scout. Use when you need to check a user's email availability (active/away) or chat status across mailboxes.
Input parameters
The unique identifier of the user whose status to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_VOLUME_BY_CHANNEL_REPORTTool to retrieve conversation volume by channel (email, chat, phone) over a specified time period. Use when you need to analyze conversation volume trends across different communication channels. Requires Help Scout Plus or Pro plan.
Input parameters
End of the interval in ISO 8601 format (e.g., '2024-01-31T23:59:59Z'). Required parameter for the report date range.
Comma-separated list of tag IDs to filter results. Only includes conversations with specified tags.
Start of the interval in ISO 8601 format (e.g., '2024-01-01T00:00:00Z'). Required parameter for the report date range.
Comma-separated list of conversation types to include. Valid values: email, chat, phone. If not specified, all types are included.
Data resolution period options.
Comma-separated list of folder IDs to filter results. Only includes conversations from specified folders.
Comma-separated list of mailbox IDs to filter results. Only includes conversations from specified mailboxes.
Ending date for comparison period in ISO 8601 format. When provided with previousStart, enables comparison with a previous time period.
Beginning date for comparison period in ISO 8601 format. When provided with previousEnd, enables comparison with a previous time period.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_GET_WEBHOOKTool to retrieve a specific webhook by ID from Help Scout. Use when you need to view webhook configuration details including URL, events, state, and other settings.
Input parameters
The unique identifier of the webhook to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_LIST_CHAT_HANDLESTool to list all chat handles for a specific customer in Help Scout. Use when you need to retrieve chat service accounts (Skype, AIM, ICQ, etc.) associated with a customer.
Input parameters
Unique identifier for the customer whose chat handles to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_LIST_CONVERSATIONSTool to list and filter conversations from Help Scout. Use when you need to retrieve multiple conversations, search by status/tags/assignee, or access conversations modified since a specific date. Returns paginated results with conversation details including subject, status, customer info, and tags. Use the thread resource link inside each Conversation entity to load conversation threads separately.
Input parameters
Filter by tag name. Returns conversations tagged with the specified tag.
Page number for pagination. Use to retrieve subsequent pages of results.
Search query using Mailbox API query syntax. Allows complex filtering with operators like AND, OR, NOT.
Filter by conversation number. Returns the conversation with this specific number.
Conversation status values.
Filter by mailbox ID. Returns conversations from the specified mailbox only.
Sort field options for conversations.
Sort order options.
Filter by assigned user ID. Returns conversations assigned to the specified user.
Filter by modification date. Returns conversations modified since this ISO 8601 timestamp.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_LIST_CUSTOMER_EMAILSTool to list all emails for a specific customer in Help Scout. Use when you need to retrieve all email addresses associated with a customer profile.
Input parameters
Unique identifier for the customer whose emails to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_LIST_CUSTOMER_PHONESTool to list all phone numbers for a specific Help Scout customer. Use when you need to retrieve the phone contact information for a customer.
Input parameters
The unique identifier of the customer whose phones to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_LIST_CUSTOMER_PROPERTIESTool to list all customer property definitions. Use when you need to view all custom properties configured for customers in the Help Scout account.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_LIST_CUSTOMERSTool to list customers in Help Scout with optional filters for name, email, or modification date. Use when you need to retrieve a list of customers, search for specific customers, or get customers modified since a certain date. Returns paginated results.
Input parameters
Page number for pagination (starts at 1)
Filter customers by email address
Filter customers by last name
Filter customers by first name
Filter customers modified since this date in ISO 8601 format
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_LIST_CUSTOMER_WEBSITESTool to list all websites associated with a specific customer in Help Scout. Use when you need to retrieve all website URLs linked to a customer profile.
Input parameters
Unique customer identifier to retrieve websites for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_LIST_INBOX_CUSTOM_FIELDSTool to list all custom fields configured for a specific inbox. Use when you need to retrieve custom field definitions including field types, options, and display order.
Input parameters
Unique identifier for the mailbox to retrieve custom fields from
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_LIST_INBOXESTool to list all mailboxes (inboxes) the user has access to with pagination support. Use when you need to retrieve a list of all available inboxes or mailboxes.
Input parameters
Page number for pagination. Defaults to 1 if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_LIST_INBOX_FOLDERSTool to retrieve all folders within a specific inbox/mailbox. Use when you need to list folders for organizing conversations or access folder details like ticket counts.
Input parameters
Page number to retrieve. Default: 1.
Unique identifier for the mailbox to retrieve folders from
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_LIST_ORGANIZATIONSTool to list all organizations (companies) in Help Scout with optional filtering and sorting. Use when you need to retrieve a list of organizations, search for specific organizations by name, or get paginated organization results.
Input parameters
Filter organizations by name. Performs a partial match search.
Page number for pagination (starts at 1). Default is 1.
Sort field options for organizations.
Sort order options.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_LIST_ORGANIZATIONS_PROPERTIESTool to list all organization property definitions. Use when you need to view all custom properties configured for organizations in the Help Scout account.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_LIST_SAVED_REPLIESTool to list saved replies for a mailbox. Use when you need to retrieve all saved reply templates available in a specific mailbox.
Input parameters
The mailbox identifier to list saved replies from.
Should all saved replies (also chat-only) be included in response? Defaults to false if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_LIST_SOCIAL_PROFILESTool to list all social profiles for a customer in Help Scout. Use when you need to retrieve a customer's social media profile information (LinkedIn, Twitter, Facebook, etc.).
Input parameters
The unique identifier of the customer whose social profiles to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_LIST_TAGSTool to list all tags in Help Scout with pagination support. Use when you need to retrieve all available tags in alphabetical order. Returns tag details including name, color, and ticket count.
Input parameters
Page number for pagination. Defaults to 1 if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_LIST_TEAMSTool to list all teams in Help Scout with pagination support. Use when you need to retrieve a list of all available teams.
Input parameters
Page number for pagination. Defaults to 1 if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_LIST_THREADSTool to list all threads for a specific Help Scout conversation. Use when you need to retrieve the complete message history and interactions within a conversation. Threads are sorted by createdAt from newest to oldest by default.
Input parameters
Page number to retrieve. Default: 1.
The unique conversation identifier
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_LIST_USERSTool to list all users in the Help Scout account with optional filters for mailbox or email. Use when you need to retrieve a list of team members, check user roles, or find users by email or mailbox assignment.
Input parameters
Page number for pagination (starts at 1)
Filter users by email address to find a specific user
Filter users by mailbox ID to get only users assigned to that mailbox
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_LIST_USERS_STATUSTool to list the status of all users including email and chat availability. Use when you need to check which users are currently active, away, or available for different channels.
Input parameters
Page number for pagination. Defaults to 1 if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_LIST_WEBHOOKSTool to retrieve all webhooks configured in Help Scout. Use when you need to view all webhook subscriptions and their configurations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_LIST_WORKFLOWSTool to list all workflows (automation rules) in the account with optional filters for mailbox, type, and status. Use when you need to retrieve workflows to view automation rules configured in Help Scout.
Input parameters
Page number for pagination (starts at 1)
Workflow type enumeration.
Workflow status enumeration.
Filter workflows by mailbox ID
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_OVERWRITE_CUSTOMERTool to overwrite an existing customer in Help Scout, replacing all customer data. Use when you need to completely replace a customer's profile information. Fields not provided in the request will be set to null, effectively removing them.
Input parameters
Age or age range descriptor. If not provided, will be set to null.
Phone number for the customer. Used when creating new customer.
Gender enumeration for customer profiles.
Job title (max 60 characters). If not provided, will be set to null.
Customer's last name (1-40 characters). If not provided, will be set to null.
Customer's location (max 60 characters). If not provided, will be set to null.
URL to profile photo (max 200 characters). If not provided, will be set to null.
Customer's first name (1-40 characters). If not provided, will be set to null.
Photo type enumeration for customer profile photos.
Background information or notes from the user interface (max 200 characters). If not provided, will be set to null.
Unique customer identifier to overwrite
Organization name (max 60 characters). DEPRECATED: use organizationId instead. If not provided, will be set to null.
Organization ID reference. If not provided, will be set to null.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_PUBLISH_THREAD_SCHEDULETool to publish a scheduled thread immediately in a Help Scout conversation. Use when you need to send a scheduled message sooner than originally planned. The draft thread is turned into a reply/forward thread and the message is sent to the customer immediately.
Input parameters
The unique identifier of the scheduled thread to publish immediately
The unique identifier of the conversation containing the scheduled thread
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_REMOVE_ORGANIZATION_PROPERTY_VALUETool to remove an organization property value. Use when clearing the value of a custom property for a specific organization. The property definition itself is not deleted, only its value for this organization is cleared.
Input parameters
Property definition's unique slug identifier. This is the key used to identify the property in the API.
The organization's unique identifier
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_RUN_MANUAL_WORKFLOWTool to run a manual workflow on one or more conversations in Help Scout. Use when you need to execute workflow actions on specific conversations. Only manual workflows can be executed via this action, and all conversation IDs must be from the same inbox as the workflow.
Input parameters
The identifier of the manual workflow to execute
An array of conversation IDs to apply the workflow to. The workflow actions will be applied to each conversation. Maximum of 50 IDs per request. All conversation IDs must belong to existing conversations and be from the same inbox as the workflow.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_SET_ORGANIZATION_PROPERTY_VALUETool to set or update a property value for a specific organization. Use when you need to assign a value to a custom property field on an organization, such as setting their tier, industry, or other metadata.
Input parameters
Property definition's unique slug identifier. This is the key used to identify the property in the API.
The property value formatted as a string. Format requirements vary by property type: text/URL (plain string), number ('100'), date ('2024-01-15' in ISO 8601 format), dropdown (option label). If a property already has a value, it will be replaced with this new value.
Unique identifier of the organization to set the property value for
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_SET_USER_STATUSTool to set the status of a user in Help Scout. Use when you need to change a user's availability to 'active' or 'away'. Administrators and Account Owners can edit other users' status.
Input parameters
The status to set for the user: 'active' (available) or 'away' (unavailable)
The unique identifier of the user whose status to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_UPDATE_CHAT_HANDLETool to update a chat handle for a Help Scout customer. Use when you need to modify an existing chat platform username (like Skype, AIM, Yahoo) associated with a customer's profile.
Input parameters
Chat platform type. Must be one of: aim, gtalk, icq, msn, other, qq, skype, xmpp, yahoo
The updated chat handle/username on the specified platform
The customer ID whose chat handle to update
The chat handle ID to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_UPDATE_CONVERSATIONTool to update specific properties of a Help Scout conversation using JSON Patch format. Use when you need to modify conversation subject, status, assignment, mailbox, primary customer, or draft status. Each request updates one field at a time.
Input parameters
JSON Patch operation: add, move, remove, or replace
Field path to update. Valid paths: /subject (string), /primaryCustomer.id (number), /draft (boolean), /mailboxId (number, use 'move' op), /status (string: active/closed/pending/spam), /assignTo (number, supports 'remove' to unassign)
New value for the field. Required for add/replace/move operations, omit for remove operation. Type depends on path: string for subject/status, number for primaryCustomer.id/mailboxId/assignTo, boolean for draft
The unique identifier of the conversation to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_UPDATE_CONVERSATION_TAGSTool to update tags on a conversation in Help Scout. Use when you need to add, remove, or replace tags on a conversation. This operation replaces the entire tag set - any existing tags not included will be removed.
Input parameters
Complete list of tag names to apply to the conversation. This replaces all existing tags - tags not in this list will be removed. Non-existent tags are created automatically. To remove all tags, pass an empty array
Unique identifier for the conversation
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_UPDATE_CONVERSATION_THREAD_SCHEDULETool to update an existing schedule for a conversation thread in Help Scout. Use when you need to change when a reply or forward thread should be sent. Subsequent requests override previous schedules for the same thread.
Input parameters
Identifier for the thread to schedule
ISO 8601 date string in the future when the thread should be sent. Must not be after year 2100.
Whether the reply should be sent as the draft's original creator. Defaults to false.
Identifier for the conversation containing the thread
Determines if a new customer reply should unschedule the thread
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_UPDATE_CUSTOMERTool to update an existing customer in Help Scout using JSON Patch operations. Use when you need to modify specific customer fields without replacing the entire record. Supports updating profile fields, address, and collections (emails, phones, etc.).
Input parameters
Array of JSON Patch operations to apply. Each operation must specify op (add/replace/remove), path (field to modify), and value (for add/replace ops). Supports fields: firstName, lastName, age, gender, jobTitle, location, organization, background, photoUrl, photoType, address fields, and collections (emails, phones, chats, social-profiles, websites).
Unique customer identifier to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_UPDATE_CUSTOMER_ADDRESSTool to update an existing address for a Help Scout customer. Use when you need to modify a customer's physical address.
Input parameters
City of the address.
Address lines (street address, building number, etc.).
State or province of the address.
Country code of the address (typically 2-letter ISO code).
The unique identifier for the customer.
Postal code or ZIP code of the address.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_UPDATE_CUSTOMER_EMAILTool to update an existing email for a customer in Help Scout. Use when you need to modify a customer's email address or change its type (home/work/other).
Input parameters
Email category - home, other, or work
Updated email address for the customer
Identifier of the email entry to update
Identifier of the customer whose email to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_UPDATE_CUSTOMER_PHONETool to update an existing phone number for a Help Scout customer. Use when modifying phone number details or type for a customer's profile.
Input parameters
Phone location type. Must be one of: fax, home, mobile, other, pager, work
The updated telephone number
The unique identifier for the phone number to update
The unique identifier for the customer whose phone should be updated
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_UPDATE_CUSTOMER_PROPERTIESTool to update custom property values for a Help Scout customer using JSON Patch operations. Use when you need to modify existing property values like subscription plan, tier level, or custom attributes. Properties must be created first before updating values.
Input parameters
The unique identifier of the customer whose properties to update
Array of JSON Patch operations to apply to the customer's properties. Each operation modifies a single property. Properties must be created first via the Create Property endpoint or web UI
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_UPDATE_CUSTOMER_SOCIAL_PROFILETool to update an existing social profile for a customer in Help Scout. Use when you need to modify a customer's social media profile URL or handle, or change its type.
Input parameters
The type of social profile (e.g., twitter, facebook, linkedin, etc.).
The social profile URL or handle. For URLs, provide the full URL (e.g., 'https://twitter.com/testuser'). For handles, provide the username.
The unique identifier of the customer who owns the social profile.
The unique identifier of the social profile to update.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_UPDATE_CUSTOMER_WEBSITETool to update an existing website URL for a customer in Help Scout. Use when modifying a website entry on a customer's profile.
Input parameters
The updated website URL
The ID of the website entry to update
The ID of the customer whose website to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_UPDATE_CUSTOM_FIELDSTool to update custom fields on a Help Scout conversation. The complete fields list replaces existing data—omitted fields are removed. Use when you need to set or clear custom field values on a conversation.
Input parameters
List of custom fields to be applied to the conversation. Complete list replaces existing data—omitted fields are removed. Empty array clears all custom fields.
The unique conversation identifier
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_UPDATE_MAILBOXES_ROUTINGTool to update routing configuration for a mailbox inbox in Help Scout. Use when you need to enable/disable routing, change assignment limits, modify assignment strategy, or update the list of users in rotation.
Input parameters
Routing configuration state - 'enabled' or 'disabled'
List of user IDs to include in the rotation. Must not be empty when routing state is 'enabled'. Users must be active and have access to the mailbox.
Unique identifier for the mailbox to update routing configuration
Maximum number of conversations that can be assigned (range: 1-100)
Assignment strategy for distributing conversations - 'round_robin' assigns to users in sequence, 'balanced' assigns to users with fewest active conversations
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_UPDATE_ORGANIZATIONTool to update an organization in Help Scout. Use when you need to modify organization details such as name, website, domains, or contact information. This is a complete update operation - provide all fields to avoid removal of existing data.
Input parameters
Organization name (required). This is a complete update - all required fields must be provided.
Internal notes about the organization (visible only to team members). Omitting this will clear the note.
Array of phone numbers associated with the organization (required). Provide empty array if no phones.
Array of domain strings associated with the organization (required). Provide empty array if no domains.
Organization website URL (required). This is a complete update - all required fields must be provided.
Physical location of the organization. Omitting this will clear the location.
Brand color in hex format (e.g., #fefefe). Omitting this will clear the brand color.
Description of the organization. Omitting this will clear the description.
The unique identifier for the organization to update.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_UPDATE_ORGANIZATION_PROPERTYTool to update an organization property definition in Help Scout. Use when you need to modify the name or options of an existing custom property. Note: Property type and slug cannot be changed after creation.
Input parameters
Updated name of the property; maximum 100 characters
The identifier for the organization property being updated. This is the property's unique slug.
The updated list of options for a dropdown property. Maximum 100 options. When provided, this completely replaces existing options. Note: Removing options will delete all property values for those options.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_UPDATE_ORGANIZATION_PROPERTY_INDUSTRYTool to update the industry organization property definition in Help Scout. Use when you need to modify the display name or available dropdown options for the industry field. Note: updating options replaces the entire list and removed options cascade delete existing values.
Input parameters
Updated display name for the industry property. Maximum 100 characters.
Updated list of industry options for the dropdown. Maximum 100 options. When provided, the entire options list is replaced - any removed options will cascade delete existing values.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_UPDATE_SAVED_REPLYTool to update an existing saved reply in a Help Scout mailbox. Use when you need to modify the name or content of a saved reply template.
Input parameters
The name of the saved reply. This is used to identify and search for the reply.
The saved reply's text content for email messages. Supports HTML formatting with tags like <br /> for line breaks.
The saved reply's text content for chat messages. Use plain text with newline characters (\\n) for line breaks instead of HTML.
The mailbox ID where the saved reply exists. This identifies which mailbox the saved reply belongs to.
The unique identifier of the saved reply to update.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_UPDATE_SNOOZETool to update or set a snooze on a Help Scout conversation. Use when you need to snooze a conversation until a specific date/time, optionally unsnoozing when the customer replies.
Input parameters
ISO 8601 date string in the future when the conversation should be unsnoozed. Must not be after year 2100.
Unique identifier for the conversation to snooze
Whether a new customer response should automatically unsnooze the conversation
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_UPDATE_THREADTool to update a specific thread in a Help Scout conversation using JSON Patch format. Use when you need to modify thread text content or hide/unhide a thread. Requires admin-level access or thread editing enabled for the account.
Input parameters
JSON Patch operation type. Only 'replace' is supported for thread updates
Field path to update. Valid paths: /text (modify thread text content), /hidden (hide/unhide thread - applies to non-draft customer or reply threads only)
New value for the field. Use string for /text path (thread content), boolean for /hidden path (true to hide, false to unhide). Note: Original text is saved and viewable on Help Scout website
The unique identifier of the thread to update
The unique identifier of the conversation containing the thread
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_UPDATE_WEBHOOKTool to update an existing webhook subscription in Help Scout. Use when modifying webhook configuration such as URL, events, secret, or other settings.
Input parameters
The callback URL where webhook events will be sent
Label to identify the webhook
Array of event names to subscribe to for webhook notifications
Secret key for webhook signature verification (max 40 characters)
Array of mailbox IDs to scope webhook to specific mailboxes. If omitted, webhook applies to all mailboxes
The unique identifier of the webhook to update
If true, sends only resource URI instead of full payload
Webhook payload version.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
HELP_SCOUT_UPDATE_WORKFLOW_STATUSTool to update the status of a Help Scout workflow (enable/disable automation rule). Use when you need to activate or deactivate a workflow.
Input parameters
New status for the workflow: active to enable, inactive to disable
The unique identifier of the workflow to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 32 agents privately built on Nagent that already use Help Scout.
Build on Nagent
Connect Help Scout to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Help Scout, and click "Connect Now." You'll authenticate with OAuth — Nagent handles credential storage and refresh automatically. Once connected, Help Scout is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Help Scout is connected, you configure its 129 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Help Scout steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Help Scout event fires, the agent kicks off automatically.
Every Help Scout action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Help Scout ships with 129 pre-built customer support actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Help Scout together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Help Scout-based workflows tailored to your business.