Skip to main content
Helpdesk logo
  • Category: customer support
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 14
  • Triggers: 0
  • Slug: HELPDESK
  • Version: 20261101_00

Tools

Slug: HELPDESK_LIST_AGENTSLists 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HELPDESK_LIST_CANNED_RESPONSESTool to list canned responses. Use when you need to retrieve all predefined reply templates for tickets.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HELPDESK_LIST_CUSTOM_FIELDSTool to list all custom fields defined in the account. Use when you need to view or manage custom fields. Only callable after authentication.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HELPDESK_LIST_EMAIL_DOMAINSLists 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HELPDESK_LIST_LICENSESRetrieves 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HELPDESK_LIST_REPLY_ADDRESSESLists 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HELPDESK_LIST_RULESTool to retrieve a list of rules configured in the account. Use after authentication when you need an overview of all automation rules.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HELPDESK_LIST_SUBSCRIPTIONSLists 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

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.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HELPDESK_LIST_TEAMSLists 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HELPDESK_LIST_TICKETSLists 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

string ("tickets" | "archive" | "trash" | "spam")
Silo/folder to list tickets from. Defaults to ‘tickets’.
string ("asc" | "desc")
Sort direction (asc or desc).
string ("createdAt" | "updatedAt" | "lastMessageAt")
Field to sort by.
string
ID of last item on current page (forward cursor).
string
ID of first item on current page (backward cursor).
integer
Number of results per page (1-100).
string
Timestamp of last item on current page (forward cursor).
string
Timestamp of first item on current page (backward cursor).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HELPDESK_LIST_TRUSTED_EMAILSTool to retrieve a list of trusted email addresses or domains. Use when managing your spam whitelist after authenticating.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HELPDESK_LIST_VIEWSTool to list agent views. Use when you need to retrieve saved ticket views after authentication.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HELPDESK_LIST_WEBHOOKSLists configured HelpDesk webhooks for ticket events. Response validation can fail for custom-field event webhooks.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: HELPDESK_VIEW_AGENTRetrieves 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

string
required
The unique identifier (UUID format) of the agent to retrieve. Obtain agent IDs from the list_agents action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not