> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Helpdesk

> HelpDesk is a ticketing system designed to streamline customer support by organizing and managing inquiries efficiently.

![Helpdesk logo](https://mintcdn.com/composio-preview/o1IUBrrsmtgkhmyf/images/toolkits/helpdesk.svg?fit=max\&auto=format\&n=o1IUBrrsmtgkhmyf\&q=85\&s=b078833377775dfcd34ec4f7a85e25ae)

* **Category:** customer support
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 14
* **Triggers:** 0
* **Slug:** `HELPDESK`
* **Version:** 20261101\_00

## Tools

> [accordion] List Agents
>
> **Slug:** `HELPDESK_LIST_AGENTS`
>
> Lists support agents in the HelpDesk account, including their profiles, roles, team memberships, status, auto-assignment settings, and signatures. No parameters are required. Use it to find agent IDs or review team composition and role assignments.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Canned Responses
>
> **Slug:** `HELPDESK_LIST_CANNED_RESPONSES`
>
> Tool to list canned responses. Use when you need to retrieve all predefined reply templates for tickets.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Custom Fields
>
> **Slug:** `HELPDESK_LIST_CUSTOM_FIELDS`
>
> Tool to list all custom fields defined in the account. Use when you need to view or manage custom fields. Only callable after authentication.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Email Domains
>
> **Slug:** `HELPDESK_LIST_EMAIL_DOMAINS`
>
> Lists all email domains configured for the HelpDesk account. Returns a comprehensive list of all email domains set up in the HelpDesk account, including domain names, verification status, DNS records, and configuration flags. Email domains allow you to send and receive tickets via custom email addresses. Use this action to: - Get domain IDs and names for use in other API operations - Check domain verification and setup status - View DNS configuration requirements - Audit which domains are actively being used for inbox No parameters required - returns all email domains accessible to the authenticated account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Licenses
>
> **Slug:** `HELPDESK_LIST_LICENSES`
>
> Retrieves all licenses (account configurations) for the authenticated HelpDesk account. A license represents a customer account and contains subscription information, global settings, default team/template assignments, and detected languages. Most accounts have one license. Use this action to: - Check account configuration and settings - Get account ID and metadata - View default team and template assignments - Inspect company settings and feature flags No parameters required - returns all licenses for the authenticated account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Reply Addresses
>
> **Slug:** `HELPDESK_LIST_REPLY_ADDRESSES`
>
> Lists all reply addresses configured in the HelpDesk account. Reply addresses are email addresses used to receive and respond to support tickets. Each reply address must be associated with a verified email domain and can be used as the "From" address when sending ticket responses to customers. Use this action to: - Get all available reply addresses and their verification status - Retrieve reply address IDs for use in other operations (e.g., creating mailboxes) - Check which email domains are being used for reply addresses - Audit reply address configuration across the account No parameters required - returns all reply addresses accessible to the authenticated account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Rules
>
> **Slug:** `HELPDESK_LIST_RULES`
>
> Tool to retrieve a list of rules configured in the account. Use after authentication when you need an overview of all automation rules.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Subscriptions
>
> **Slug:** `HELPDESK_LIST_SUBSCRIPTIONS`
>
> Lists all billing subscriptions for the HelpDesk account, including active, expired, canceled, and future subscriptions. Subscriptions represent the currently selected plan (team or enterprise) and number of paid agent slots. Use this tool to retrieve subscription details including plan codes, pricing, billing cycles, trial periods, and subscription states. Both filter parameters are optional - omit them to retrieve all subscriptions.
>
> #### Input Parameters
>
> **state** `string ("active" | "expired" | "canceled" | "future" | "pending")`
>
> Optional: Filter by subscription status. Options: 'active' (currently in use), 'expired' (past end date), 'canceled' (manually terminated), 'future' (not yet started), 'pending' (awaiting activation). Omit to include all states.
>
> **plan\_codes** `array`
>
> Optional: Filter by specific plan codes. Plan naming: 'hd-\{tier}\{duration}m' where tier is 'team' or 'enterprise', duration is billing period in months (1, 3, 6, 12, 24, or 36). Examples: 'hd-team12m' (Team plan, 12 months), 'hd-enterprise6m' (Enterprise plan, 6 months). Omit to include all plan types.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Teams
>
> **Slug:** `HELPDESK_LIST_TEAMS`
>
> Lists all teams in the HelpDesk account. Returns a comprehensive list of all teams configured in the HelpDesk account, including team IDs, names, settings, reply addresses, and integration configurations. Teams are organizational units that group agents and manage ticket routing. Use this action to: - Get team IDs for use in other API operations - Retrieve team names and configurations - Audit team settings and reply addresses - View team integration configurations No parameters required - returns all teams accessible to the authenticated account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Tickets
>
> **Slug:** `HELPDESK_LIST_TICKETS`
>
> Lists tickets from a specified silo using cursor-based pagination, configurable page size, and sorting. The API defaults to open status, and this tool does not expose a status filter; totals default to zero when response headers are absent.
>
> #### Input Parameters
>
> **silo** `string ("tickets" | "archive" | "trash" | "spam")`
>
> Silo/folder to list tickets from. Defaults to 'tickets'.
>
> **order** `string ("asc" | "desc")`
>
> Sort direction (asc or desc).
>
> **sortBy** `string ("createdAt" | "updatedAt" | "lastMessageAt")`
>
> Field to sort by.
>
> **next.ID** `string`
>
> ID of last item on current page (forward cursor).
>
> **prev.ID** `string`
>
> ID of first item on current page (backward cursor).
>
> **pageSize** `integer`
>
> Number of results per page (1-100).
>
> **next.value** `string`
>
> Timestamp of last item on current page (forward cursor).
>
> **prev.value** `string`
>
> Timestamp of first item on current page (backward cursor).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Trusted Emails
>
> **Slug:** `HELPDESK_LIST_TRUSTED_EMAILS`
>
> Tool to retrieve a list of trusted email addresses or domains. Use when managing your spam whitelist after authenticating.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Views
>
> **Slug:** `HELPDESK_LIST_VIEWS`
>
> Tool to list agent views. Use when you need to retrieve saved ticket views after authentication.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Webhooks
>
> **Slug:** `HELPDESK_LIST_WEBHOOKS`
>
> Lists configured HelpDesk webhooks for ticket events. Response validation can fail for custom-field event webhooks.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] View Agent
>
> **Slug:** `HELPDESK_VIEW_AGENT`
>
> Retrieves comprehensive details for a specific agent in the HelpDesk system. Returns complete agent information including profile details, role assignments, team memberships, status, settings, and signature configuration. Use this action when you need detailed information about a specific agent after obtaining their ID from the list\_agents action.
>
> #### Input Parameters
>
> **agentID** `string` *required*
>
> The unique identifier (UUID format) of the agent to retrieve. Obtain agent IDs from the list\_agents action.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
