# Help Scout Help Scout provides customer support software with shared inbox, knowledge base, and customer management tools - **Category:** customer support - **Auth:** OAUTH2 - **Composio Managed App Available?** No - **Tools:** 129 - **Triggers:** 0 - **Slug:** `HELP_SCOUT` - **Version:** 20260417_00 ## Tools ### Create Chat Handle **Slug:** `HELP_SCOUT_CREATE_CHAT_HANDLE` Tool 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. ### Create Chat Thread **Slug:** `HELP_SCOUT_CREATE_CHAT_THREAD` Tool 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. ### Create Conversation **Slug:** `HELP_SCOUT_CREATE_CONVERSATION` Tool to create a new conversation in Help Scout. Use when creating email, phone, or chat conversations with customer threads. ### Create Customer **Slug:** `HELP_SCOUT_CREATE_CUSTOMER` Tool 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. ### Create Customer Address **Slug:** `HELP_SCOUT_CREATE_CUSTOMER_ADDRESS` Tool to create an address for a Help Scout customer. Use when you need to add a physical address to a customer's profile. ### Create customer email **Slug:** `HELP_SCOUT_CREATE_CUSTOMER_EMAIL` Tool 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. ### Create Customer Phone **Slug:** `HELP_SCOUT_CREATE_CUSTOMER_PHONE` Tool to create a phone number for a Help Scout customer. Use when adding contact phone numbers to customer profiles. ### Create Customer Property **Slug:** `HELP_SCOUT_CREATE_CUSTOMER_PROPERTY` Tool 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. ### Create Customer Thread **Slug:** `HELP_SCOUT_CREATE_CUSTOMER_THREAD` Tool 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. ### Create Customer Website **Slug:** `HELP_SCOUT_CREATE_CUSTOMER_WEBSITE` Tool to create a website entry for a customer in Help Scout. Use when adding a website URL to an existing customer profile. ### Create Note on Conversation **Slug:** `HELP_SCOUT_CREATE_NOTE` Tool 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. ### Create Organization **Slug:** `HELP_SCOUT_CREATE_ORGANIZATION` Tool to create a new organization in Help Scout. Use when you need to create a company profile with associated domains, contact information, and metadata. ### Create Organization Property **Slug:** `HELP_SCOUT_CREATE_ORGANIZATION_PROPERTY` Tool 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. ### Create Phone Thread **Slug:** `HELP_SCOUT_CREATE_PHONE_THREAD` Tool 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. ### Create Reply Thread **Slug:** `HELP_SCOUT_CREATE_REPLY_THREAD` Tool 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. ### Create saved reply **Slug:** `HELP_SCOUT_CREATE_SAVED_REPLY` Tool 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. ### Create Social Profile **Slug:** `HELP_SCOUT_CREATE_SOCIAL_PROFILE` Tool 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. ### Create Webhook **Slug:** `HELP_SCOUT_CREATE_WEBHOOK` Tool 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. ### Delete Chat Handle **Slug:** `HELP_SCOUT_DELETE_CHAT_HANDLE` Tool to delete a chat handle for a customer. Use when you need to remove a chat handle associated with a customer account. ### Delete Conversation **Slug:** `HELP_SCOUT_DELETE_CONVERSATION` Tool 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. ### Delete customer **Slug:** `HELP_SCOUT_DELETE_CUSTOMER` Tool 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. ### Delete Customer Address **Slug:** `HELP_SCOUT_DELETE_CUSTOMER_ADDRESS` Tool to delete a customer's address from Help Scout. Use when you need to remove address information associated with a specific customer account. ### Delete Customer Email **Slug:** `HELP_SCOUT_DELETE_CUSTOMER_EMAIL` Tool to delete an email for a customer. Use when you need to remove a customer's email address from Help Scout. ### Delete Customer Phone **Slug:** `HELP_SCOUT_DELETE_CUSTOMER_PHONE` Tool 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. ### Delete Customer Property **Slug:** `HELP_SCOUT_DELETE_CUSTOMER_PROPERTY` Tool 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. ### Delete Customer Website **Slug:** `HELP_SCOUT_DELETE_CUSTOMER_WEBSITE` Tool to delete a website for a customer. Use when you need to remove a website from a customer record. ### Delete Organization **Slug:** `HELP_SCOUT_DELETE_ORGANIZATION` Tool 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. ### Delete Organization Property Customer Tier **Slug:** `HELP_SCOUT_DELETE_ORGANIZATION_PROPERTY_CUSTOMER_TIER` Tool 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. ### Delete Saved Reply **Slug:** `HELP_SCOUT_DELETE_SAVED_REPLY` Tool 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. ### Delete Snooze **Slug:** `HELP_SCOUT_DELETE_SNOOZE` Tool 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). ### Delete Social Profile **Slug:** `HELP_SCOUT_DELETE_SOCIAL_PROFILE` Tool 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. ### Delete Thread Schedule **Slug:** `HELP_SCOUT_DELETE_THREAD_SCHEDULE` Tool 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. ### Delete Webhook **Slug:** `HELP_SCOUT_DELETE_WEBHOOK` Tool to permanently delete a webhook subscription from Help Scout. Use when you need to remove webhook integrations that are no longer needed. ### Download Attachment **Slug:** `HELP_SCOUT_DOWNLOAD_ATTACHMENT` Tool to download an attachment file from a Help Scout conversation. Use when you need to retrieve the actual file content of an attachment. ### Get Attachment Data **Slug:** `HELP_SCOUT_GET_ATTACHMENT_DATA` Tool to retrieve attachment data for a specific attachment. Returns base64-encoded attachment content. ### Get Busy Times Report **Slug:** `HELP_SCOUT_GET_BUSY_TIMES_REPORT` Tool 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. ### Get Chat Report **Slug:** `HELP_SCOUT_GET_CHAT_REPORT` Tool 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. ### Get Company Customers Helped Report **Slug:** `HELP_SCOUT_GET_COMPANY_CUSTOMERS_HELPED_REPORT` Tool 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. ### Get Company Drilldown Report **Slug:** `HELP_SCOUT_GET_COMPANY_DRILLDOWN_REPORT` Tool 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. ### Get Company Report **Slug:** `HELP_SCOUT_GET_COMPANY_REPORT` Tool 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. ### Get Conversation **Slug:** `HELP_SCOUT_GET_CONVERSATION` Tool 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. ### Get Conversations Drilldown Report **Slug:** `HELP_SCOUT_GET_CONVERSATIONS_DRILLDOWN` Tool 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. ### Get Conversations Field Drilldown Report **Slug:** `HELP_SCOUT_GET_CONVERSATIONS_FIELD_DRILLDOWN` Tool 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. ### Get Conversations Report **Slug:** `HELP_SCOUT_GET_CONVERSATIONS_REPORT` Tool 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. ### Get Customer **Slug:** `HELP_SCOUT_GET_CUSTOMER` Tool 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. ### Get Customer Address **Slug:** `HELP_SCOUT_GET_CUSTOMER_ADDRESS` Tool to retrieve a customer's address from Help Scout. Use when you need to fetch the physical address associated with a specific customer account. ### Get Docs Report **Slug:** `HELP_SCOUT_GET_DOCS_REPORT` Tool 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. ### Get Email Report **Slug:** `HELP_SCOUT_GET_EMAIL_REPORT` Tool 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. ### Get First Response Time Report **Slug:** `HELP_SCOUT_GET_FIRST_RESPONSE_TIME_REPORT` Tool 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. ### Get Happiness Ratings Report **Slug:** `HELP_SCOUT_GET_HAPPINESS_RATINGS_REPORT` Tool 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. ### Get Happiness Report **Slug:** `HELP_SCOUT_GET_HAPPINESS_REPORT` Tool 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. ### Get Inbox **Slug:** `HELP_SCOUT_GET_INBOX` Tool 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. ### Get New Conversations Drilldown Report **Slug:** `HELP_SCOUT_GET_NEW_CONVERSATIONS_DRILLDOWN` Tool 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. ### Get New Conversations Report **Slug:** `HELP_SCOUT_GET_NEW_CONVERSATIONS_REPORT` Tool 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. ### Get Organization **Slug:** `HELP_SCOUT_GET_ORGANIZATION` Tool 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. ### Get Organization Conversations **Slug:** `HELP_SCOUT_GET_ORGANIZATION_CONVERSATIONS` Tool 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. ### Get Organization Customers **Slug:** `HELP_SCOUT_GET_ORGANIZATION_CUSTOMERS` Tool 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. ### Get Organization Property **Slug:** `HELP_SCOUT_GET_ORGANIZATION_PROPERTY` Tool 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. ### Get Phone Report **Slug:** `HELP_SCOUT_GET_PHONE_REPORT` Tool 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. ### Get Productivity Report **Slug:** `HELP_SCOUT_GET_PRODUCTIVITY_REPORT` Tool 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. ### Get Received Messages Report **Slug:** `HELP_SCOUT_GET_RECEIVED_MESSAGES_REPORT` Tool 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. ### Get Replies Sent Report **Slug:** `HELP_SCOUT_GET_REPLIES_SENT_REPORT` Tool 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. ### Get Resolution Time Report **Slug:** `HELP_SCOUT_GET_RESOLUTION_TIME_REPORT` Tool 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. ### Get Resolved Report **Slug:** `HELP_SCOUT_GET_RESOLVED_REPORT` Tool 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. ### Get Resource Owner **Slug:** `HELP_SCOUT_GET_RESOURCE_OWNER` Tool to get the authenticated user's profile information. Use when you need to retrieve details about the current user. ### Get Routing Configuration **Slug:** `HELP_SCOUT_GET_ROUTING_CONFIG` Tool to retrieve routing configuration for a mailbox inbox. Use when you need to check assignment settings, rotation status, or user eligibility for receiving conversations. ### Get Saved Reply **Slug:** `HELP_SCOUT_GET_SAVED_REPLY` Tool 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. ### Get Tag **Slug:** `HELP_SCOUT_GET_TAG` Tool 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. ### Get User **Slug:** `HELP_SCOUT_GET_USER` Tool 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. ### Get User Chat Report **Slug:** `HELP_SCOUT_GET_USER_CHAT_REPORT` Tool 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. ### Get User Conversation History **Slug:** `HELP_SCOUT_GET_USER_CONVERSATION_HISTORY` Tool 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. ### Get User Customers Helped Report **Slug:** `HELP_SCOUT_GET_USER_CUSTOMERS_HELPED_REPORT` Tool 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. ### Get User Drilldown Report **Slug:** `HELP_SCOUT_GET_USER_DRILLDOWN` Tool 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. ### Get User Happiness Report **Slug:** `HELP_SCOUT_GET_USER_HAPPINESS_REPORT` Tool 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. ### Get User Ratings Report **Slug:** `HELP_SCOUT_GET_USER_RATINGS_REPORT` Tool 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. ### Get User Replies Report **Slug:** `HELP_SCOUT_GET_USER_REPLIES_REPORT` Tool 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. ### Get User Report **Slug:** `HELP_SCOUT_GET_USER_REPORT` Tool 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. ### Get User Resolutions Report **Slug:** `HELP_SCOUT_GET_USER_RESOLUTIONS_REPORT` Tool 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. ### Get User Status **Slug:** `HELP_SCOUT_GET_USER_STATUS` Tool 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. ### Get Volume by Channel Report **Slug:** `HELP_SCOUT_GET_VOLUME_BY_CHANNEL_REPORT` Tool 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. ### Get Webhook **Slug:** `HELP_SCOUT_GET_WEBHOOK` Tool 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. ### List Chat Handles **Slug:** `HELP_SCOUT_LIST_CHAT_HANDLES` Tool 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. ### List Conversations **Slug:** `HELP_SCOUT_LIST_CONVERSATIONS` Tool 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. ### List Customer Emails **Slug:** `HELP_SCOUT_LIST_CUSTOMER_EMAILS` Tool 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. ### List Customer Phones **Slug:** `HELP_SCOUT_LIST_CUSTOMER_PHONES` Tool to list all phone numbers for a specific Help Scout customer. Use when you need to retrieve the phone contact information for a customer. ### List Customer Properties **Slug:** `HELP_SCOUT_LIST_CUSTOMER_PROPERTIES` Tool to list all customer property definitions. Use when you need to view all custom properties configured for customers in the Help Scout account. ### List Customers **Slug:** `HELP_SCOUT_LIST_CUSTOMERS` Tool 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. ### List Customer Websites **Slug:** `HELP_SCOUT_LIST_CUSTOMER_WEBSITES` Tool 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. ### List Inbox Custom Fields **Slug:** `HELP_SCOUT_LIST_INBOX_CUSTOM_FIELDS` Tool 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. ### List Inboxes **Slug:** `HELP_SCOUT_LIST_INBOXES` Tool 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. ### List Inbox Folders **Slug:** `HELP_SCOUT_LIST_INBOX_FOLDERS` Tool 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. ### List Organizations **Slug:** `HELP_SCOUT_LIST_ORGANIZATIONS` Tool 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. ### List Organizations Properties **Slug:** `HELP_SCOUT_LIST_ORGANIZATIONS_PROPERTIES` Tool to list all organization property definitions. Use when you need to view all custom properties configured for organizations in the Help Scout account. ### List Saved Replies **Slug:** `HELP_SCOUT_LIST_SAVED_REPLIES` Tool to list saved replies for a mailbox. Use when you need to retrieve all saved reply templates available in a specific mailbox. ### List Social Profiles **Slug:** `HELP_SCOUT_LIST_SOCIAL_PROFILES` Tool 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.). ### List Tags **Slug:** `HELP_SCOUT_LIST_TAGS` Tool 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. ### List Teams **Slug:** `HELP_SCOUT_LIST_TEAMS` Tool to list all teams in Help Scout with pagination support. Use when you need to retrieve a list of all available teams. ### List Threads **Slug:** `HELP_SCOUT_LIST_THREADS` Tool 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. ### List Users **Slug:** `HELP_SCOUT_LIST_USERS` Tool 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. ### List Users Status **Slug:** `HELP_SCOUT_LIST_USERS_STATUS` Tool 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. ### List Webhooks **Slug:** `HELP_SCOUT_LIST_WEBHOOKS` Tool to retrieve all webhooks configured in Help Scout. Use when you need to view all webhook subscriptions and their configurations. ### List Workflows **Slug:** `HELP_SCOUT_LIST_WORKFLOWS` Tool 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. ### Overwrite Customer **Slug:** `HELP_SCOUT_OVERWRITE_CUSTOMER` Tool 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. ### Publish Thread Schedule **Slug:** `HELP_SCOUT_PUBLISH_THREAD_SCHEDULE` Tool 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. ### Remove Organization Property Value **Slug:** `HELP_SCOUT_REMOVE_ORGANIZATION_PROPERTY_VALUE` Tool 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. ### Run Manual Workflow **Slug:** `HELP_SCOUT_RUN_MANUAL_WORKFLOW` Tool 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. ### Set Organization Property Value **Slug:** `HELP_SCOUT_SET_ORGANIZATION_PROPERTY_VALUE` Tool 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. ### Set User Status **Slug:** `HELP_SCOUT_SET_USER_STATUS` Tool 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. ### Update Chat Handle **Slug:** `HELP_SCOUT_UPDATE_CHAT_HANDLE` Tool 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. ### Update Conversation **Slug:** `HELP_SCOUT_UPDATE_CONVERSATION` Tool 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. ### Update Conversation Tags **Slug:** `HELP_SCOUT_UPDATE_CONVERSATION_TAGS` Tool 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. ### Update Conversation Thread Schedule **Slug:** `HELP_SCOUT_UPDATE_CONVERSATION_THREAD_SCHEDULE` Tool 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. ### Update Customer **Slug:** `HELP_SCOUT_UPDATE_CUSTOMER` Tool 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.). ### Update Customer Address **Slug:** `HELP_SCOUT_UPDATE_CUSTOMER_ADDRESS` Tool to update an existing address for a Help Scout customer. Use when you need to modify a customer's physical address. ### Update customer email **Slug:** `HELP_SCOUT_UPDATE_CUSTOMER_EMAIL` Tool 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). ### Update Customer Phone **Slug:** `HELP_SCOUT_UPDATE_CUSTOMER_PHONE` Tool to update an existing phone number for a Help Scout customer. Use when modifying phone number details or type for a customer's profile. ### Update Customer Properties **Slug:** `HELP_SCOUT_UPDATE_CUSTOMER_PROPERTIES` Tool 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. ### Update Customer Social Profile **Slug:** `HELP_SCOUT_UPDATE_CUSTOMER_SOCIAL_PROFILE` Tool 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. ### Update Customer Website **Slug:** `HELP_SCOUT_UPDATE_CUSTOMER_WEBSITE` Tool to update an existing website URL for a customer in Help Scout. Use when modifying a website entry on a customer's profile. ### Update Custom Fields **Slug:** `HELP_SCOUT_UPDATE_CUSTOM_FIELDS` Tool 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. ### Update Mailbox Routing Configuration **Slug:** `HELP_SCOUT_UPDATE_MAILBOXES_ROUTING` Tool 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. ### Update Organization **Slug:** `HELP_SCOUT_UPDATE_ORGANIZATION` Tool 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. ### Update Organization Property **Slug:** `HELP_SCOUT_UPDATE_ORGANIZATION_PROPERTY` Tool 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. ### Update Organization Property Industry **Slug:** `HELP_SCOUT_UPDATE_ORGANIZATION_PROPERTY_INDUSTRY` Tool 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. ### Update saved reply **Slug:** `HELP_SCOUT_UPDATE_SAVED_REPLY` Tool 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. ### Update Conversation Snooze **Slug:** `HELP_SCOUT_UPDATE_SNOOZE` Tool 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. ### Update Thread **Slug:** `HELP_SCOUT_UPDATE_THREAD` Tool 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. ### Update Webhook **Slug:** `HELP_SCOUT_UPDATE_WEBHOOK` Tool to update an existing webhook subscription in Help Scout. Use when modifying webhook configuration such as URL, events, secret, or other settings. ### Update Workflow Status **Slug:** `HELP_SCOUT_UPDATE_WORKFLOW_STATUS` Tool to update the status of a Help Scout workflow (enable/disable automation rule). Use when you need to activate or deactivate a workflow.