HelpDesk is a ticketing system designed to streamline customer support by organizing and managing inquiries efficiently.
HelpDesk is a ticketing system designed to streamline customer support by organizing and managing inquiries efficiently. On Nagent, Helpdesk is exposed as a fully-configurable customer support integration that any agent can call — 14 actions, and API key authentication. No code is required to wire Helpdesk into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Helpdesk 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 Helpdesk 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 Helpdesk, with input parameters and output schema. Drop these into any step of an agent built in Helix.
HELPDESK_LIST_AGENTSRetrieves all support agents (team members) in the HelpDesk account. Use this action to get a complete list of agents with their details including: - Agent profiles (name, email, avatar, job title) - Role assignments (owner, normal, viewer) - Team memberships - Status (active or invited) - Auto-assignment settings - Email signatures This action requires no parameters and returns all agents in the account. Useful for finding agent IDs, checking team composition, or verifying permissions.
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
HELPDESK_LIST_CANNED_RESPONSESTool to list canned responses. Use when you need to retrieve all predefined reply templates for tickets.
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
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
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
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
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
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
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
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
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
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
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
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
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.
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 from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
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
HELPDESK_LIST_TICKETSList all tickets from a specified silo with cursor-based pagination support. This tool retrieves tickets from the helpdesk system with flexible sorting and pagination. Use this when you need to retrieve tickets for monitoring, reporting, or processing. Key features: - Retrieves tickets from specified silo (tickets, archive, trash, or spam) - Supports cursor-based pagination for efficient navigation through large datasets - Configurable page size (1-100 tickets per page) - Multiple sort options (createdAt, updatedAt, lastMessageAt) in ascending or descending order Common use cases: - Get all open tickets: Use default parameters with silo='tickets' - Browse archived tickets: Set silo='archive' - Paginate through results: Use next_value and next_id from previous response
Input parameters
Silo/folder to list tickets from. Defaults to 'tickets'.
Sort direction (asc or desc).
Field to sort by.
ID of last item on current page (forward cursor).
ID of first item on current page (backward cursor).
Number of results per page (1-100).
Timestamp of last item on current page (forward cursor).
Timestamp of first item on current page (backward cursor).
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
HELPDESK_LIST_TRUSTED_EMAILSTool to retrieve a list of trusted email addresses or domains. Use when managing your spam whitelist after authenticating.
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
HELPDESK_LIST_VIEWSTool to list agent views. Use when you need to retrieve saved ticket views after authentication.
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
HELPDESK_LIST_WEBHOOKSLists all configured webhooks for the HelpDesk account. Webhooks allow you to receive real-time notifications about ticket events (creation, updates, status changes, assignments, etc.) sent as HTTP POST requests to your specified URLs. Use this action to view all active webhook 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
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
The unique identifier (UUID format) of the agent to retrieve. Obtain agent IDs from the list_agents action.
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 50 agents privately built on Nagent that already use Helpdesk.
Build on Nagent
Connect Helpdesk 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 Helpdesk, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Helpdesk is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Helpdesk is connected, you configure its 14 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Helpdesk 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 Helpdesk event fires, the agent kicks off automatically.
Every Helpdesk 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 Helpdesk ships with 14 pre-built customer support actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Helpdesk together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Helpdesk-based workflows tailored to your business.