Helpwise is an easy-to-use customer service platform that helps you manage all customer communication from a single place.
Helpwise is an easy-to-use customer service platform that helps you manage all customer communication from a single place. On Nagent, Helpwise is exposed as a fully-configurable customer support integration that any agent can call — 37 actions, and API key authentication. No code is required to wire Helpwise into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Helpwise 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 Helpwise 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 Helpwise, with input parameters and output schema. Drop these into any step of an agent built in Helix.
HELPWISE_CREATE_ATTACHMENTTool to upload a new attachment. Use when you need to send a file to Helpwise and receive its attachment metadata.
Input parameters
File to upload to Helpwise.
ID of the conversation to associate this attachment with. If provided, the attachment will be linked to the specified conversation. Leave empty to create an unattached 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
HELPWISE_CREATE_NOTETool to add a note to a conversation. Use after obtaining the conversation_id to provide context.
Input parameters
Content of the note
Flag indicating if the note is internal (private) and not visible to the customer
Unique identifier of the conversation to which the note will be added
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
HELPWISE_CREATE_TEAMCreates a new team in Helpwise to group users for collaboration and assignment purposes. Use this tool when you need to: - Create a new team with a unique name - Optionally add a description for the team - Optionally assign initial members by their user IDs IMPORTANT: Team creation via API is not available in the current Helpwise API. All tested endpoints (/api/v1/teams, /dev-apis/teams, /api/v1/team, /dev-apis/team) return 404. Team management appears to be limited to the Helpwise web interface. If you need to create teams, please: 1. Use the Helpwise web interface at https://app.helpwise.io 2. Contact Helpwise support at dev@helpwise.io to request API endpoint availability This action is implemented speculatively for future API support and follows standard patterns used in other Helpwise actions.
Input parameters
Name of the team to create (must be unique within your workspace)
List of user IDs to add to the team upon creation
Optional description for the team
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
HELPWISE_CREATE_WEBHOOKCreates a new webhook subscription in Helpwise to receive real-time event notifications. Use this action to programmatically subscribe to Helpwise events like conversation creation, message replies, conversation assignments, status changes, and tag applications. Webhooks deliver JSON payloads to your specified callback URL when subscribed events occur. IMPORTANT: Helpwise webhook management is primarily done through the UI at: Settings > Automation > Integrations > Webhooks (https://app.helpwise.io/settings/integrations) This action attempts to use programmatic API endpoints, but if they're unavailable in your Helpwise plan or environment, you'll need to create webhooks manually via the UI.
Input parameters
Target URL for receiving webhook events (must return 200 status, not 404)
List of event names to subscribe to. Common events: 'conversation.created', 'conversation.assigned', 'conversation.closed', 'message.created'
Optional secret key to validate webhook authenticity and ignore unauthorized requests
Whether the webhook should be active immediately upon creation
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
HELPWISE_DELETE_CONTACTDeletes a contact from Helpwise by its unique identifier (ID). Use this action when you need to permanently remove a contact from your Helpwise account. Returns an empty response (HTTP 204 No Content) on successful deletion. Note: This action is idempotent - deleting a non-existent contact will return an appropriate error.
Input parameters
The unique identifier (ID) of the contact to delete. This can be obtained from contact listing endpoints or contact creation responses.
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
HELPWISE_DELETE_CONVERSATIONAttempts to delete a conversation by ID from Helpwise. Note: The Helpwise API may not support conversation deletion via the REST API. If deletion is not supported, this action will return an error indicating that the endpoint was not found or the method is not allowed. Use this action when you need to attempt to permanently remove a conversation by its ID.
Input parameters
Unique ID 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
HELPWISE_DELETE_MAILBOXTool to delete a mailbox by its unique identifier. NOTE: As of 2026, the Helpwise API may not support mailbox deletion via API. This action attempts deletion but will fail if the endpoint is not available (405 Method Not Allowed). Consider managing mailboxes through the Helpwise web interface if API deletion is unsupported.
Input parameters
The unique identifier (ID) of the Helpwise mailbox to delete. This should be a numeric or alphanumeric string obtained from mailbox listing endpoints.
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
HELPWISE_DELETE_MESSAGEAttempts to delete a message from Helpwise. Note: The Helpwise API may not support message deletion via the REST API. If deletion is not supported, this action will return an error indicating that the DELETE method is not allowed (HTTP 405). Use this action when you need to attempt to permanently remove a message by its ID.
Input parameters
Unique identifier of the Helpwise message 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
HELPWISE_DELETE_NOTETool to delete a note from a conversation. Use when you need to permanently remove a note by its ID from a specific conversation after confirming the IDs.
Input parameters
Unique ID of the note to delete
Unique ID of the conversation containing the note
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
HELPWISE_DELETE_SIGNATUREDeletes an email signature from Helpwise. Email signatures are text/HTML templates that automatically append to outgoing emails from specific mailboxes or users. This action permanently removes the signature identified by the signature_id. Returns an empty response on successful deletion (204 No Content).
Input parameters
Unique identifier of the email signature to delete. Email signatures are templates that automatically append to outgoing emails. The ID can be obtained from the signature management interface in Helpwise settings.
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
HELPWISE_DELETE_TAGPermanently deletes a tag from Helpwise. This action removes the tag from all conversations where it was applied and cannot be undone. Use this when you need to permanently remove a tag that is no longer needed. Note: Deleting a tag will automatically remove it from all existing conversations that use this tag.
Input parameters
The unique identifier (ID) of the tag to permanently delete. You can obtain tag IDs from the HELPWISE_GET_TAG action, from conversation responses, or from the Helpwise web interface.
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
HELPWISE_DELETE_TEAMTool to delete a team. Use when you need to remove an existing team by its unique identifier after confirming the ID and dependencies.
Input parameters
Unique identifier of the Helpwise team 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
HELPWISE_DELETE_TEMPLATEDeletes a Helpwise email template (saved reply) by its ID. Returns empty response on success (HTTP 204). Use this tool when you need to permanently remove a template that is no longer needed. Ensure the template_id is valid before deletion - this operation cannot be undone. Common responses: - Success (204): Template deleted successfully - Not Found (404): Template ID does not exist or was already deleted - Forbidden (403): No permission to delete this template
Input parameters
Unique identifier of the Helpwise template 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
HELPWISE_DELETE_WEBHOOKDelete a Helpwise webhook by its ID. Use this tool when you need to permanently remove a webhook configuration. Returns an empty response on successful deletion (HTTP 204 No Content).
Input parameters
Unique identifier of the Helpwise 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
HELPWISE_GET_ATTACHMENTRetrieves a specific attachment by its unique identifier. Use this after obtaining an attachment ID from conversations, messages, or attachment listings to get detailed attachment metadata including download URL, file name, content type, and timestamps.
Input parameters
The unique ID of the attachment you want to retrieve. Obtain this from conversations, messages, or by listing attachments.
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
HELPWISE_GET_ATTACHMENTSRetrieves attachments from messages in a specific conversation. **Important**: Helpwise does not provide a dedicated attachments endpoint. This action retrieves attachments by fetching messages from the conversation and extracting attachment information from them. A conversation_id is required to use this action. Use this when you need to: - Get all file attachments from a specific conversation - Access attachment metadata (filename, URL, size, content type) - Download files shared in customer support conversations **Note**: This action retrieves attachments through the messages endpoint, as Helpwise embeds attachment data within message objects rather than providing a standalone attachments resource.
Input parameters
Unique identifier of the conversation to fetch attachments for. Required - Helpwise retrieves attachments through messages, which must be scoped to a 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
HELPWISE_GET_CONTACTRetrieves detailed information for a specific contact by ID. Use this when you need to fetch complete contact details including name, email, phone, company, and timestamps for a known contact ID.
Input parameters
Unique identifier of the contact 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
HELPWISE_GET_CONVERSATIONRetrieves complete details of a specific conversation by ID from Helpwise. Returns the conversation metadata including subject, status, participants, and timestamps. Use this action when you need to view or analyze a specific conversation's details. Example use cases: - Checking the status of a support ticket conversation - Viewing conversation participants and assignees - Retrieving conversation metadata for reporting
Input parameters
Unique identifier of the conversation 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
HELPWISE_GET_CONVERSATIONSTool to retrieve a list of conversations. Use when you need to list and paginate support conversations for display or analysis.
Input parameters
Page number to retrieve, must be >= 1
Search term to filter conversations
Filter by conversation status
Field to sort by
Filter by team ID handling the conversation
Items per page, must be >= 1
Mailbox ID to retrieve conversations from. If not provided, retrieves conversations across all mailboxes.
Sort order: asc or desc
Filter by assignee user ID
Filter by requester user 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
HELPWISE_GET_CUSTOM_FIELDRetrieves details of a specific custom field by its ID. Use this when you need to fetch custom field properties such as name, description, value, associated inboxes, and creator information.
Input parameters
Unique identifier of the custom field 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
HELPWISE_GET_MAILBOXTool to retrieve details of a specific mailbox by its ID. Use when you know the mailbox ID and need full mailbox information.
Input parameters
Unique identifier of the mailbox 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
HELPWISE_GET_MAILBOXESTool to retrieve mailboxes. Use when you need to list and paginate mailboxes after authenticating.
Input parameters
Page number to fetch, must be 1 or greater
Number of mailboxes per page, maximum 100
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
HELPWISE_GET_NOTETool to retrieve details of a specific note. Use when you know the conversation and note IDs and need full note information.
Input parameters
Unique ID of the note to retrieve
Unique ID of the conversation containing the note
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
HELPWISE_GET_NOTESRetrieves all notes associated with a specific conversation. Notes are internal comments or annotations that team members add to conversations for collaboration and context.
Input parameters
Unique identifier of the conversation. Obtain this from conversation listing or creation endpoints.
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
HELPWISE_GET_TAGRetrieves detailed information about a specific tag in Helpwise. Use this action when you need to: - Get the full properties of a tag including its name, color, and timestamps - Verify that a tag exists before performing operations on it - Retrieve tag details for display or processing Tags in Helpwise are labels that can be applied to conversations for organization and filtering.
Input parameters
The unique identifier of the tag to retrieve. This ID is returned when listing tags or can be found in tag-related responses from other endpoints.
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
HELPWISE_GET_TEAMRetrieves details of a specific Helpwise team by its ID. Note: Team endpoints may not be available in all Helpwise API plans. If this action returns a 404 error, teams may need to be managed through the Helpwise web interface. Use this tool when you have a valid team_id and need to fetch team details such as name and timestamps.
Input parameters
Unique identifier of the Helpwise team 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
HELPWISE_GET_TEAMSTool to retrieve Helpwise teams. Use when you need to list and paginate all teams for assignment or management.
Input parameters
Page number to fetch, must be 1 or greater
Number of teams per page, maximum 100
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
HELPWISE_GET_TEMPLATESTool to retrieve Helpwise WhatsApp message templates. Use when you need to list WhatsApp templates for a mailbox or account.
Input parameters
WhatsApp mailbox ID to fetch templates for. If not provided, will attempt to fetch from any available 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
HELPWISE_GET_USERSTool to retrieve Helpwise users list. Use when you need to fetch and paginate agents for assignment.
Input parameters
Page number to fetch, must be >= 1
Number of users per page, must be >= 1
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
HELPWISE_GET_WEBHOOKRetrieve detailed configuration for a specific Helpwise webhook by its ID. Use this action when you: - Need to inspect the configuration of an existing webhook - Want to verify webhook settings (URL, events, active status) - Need to check webhook creation/update timestamps Prerequisites: You must have a valid webhook ID, which can be obtained from the 'Get Webhooks' action or when creating a webhook.
Input parameters
The unique identifier of the webhook to retrieve. This is typically a numeric ID (e.g., '123') returned when creating a webhook or from the list webhooks endpoint.
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
HELPWISE_GET_WEBHOOKSTool to retrieve Helpwise webhooks. Use when you need to list and paginate all webhook configurations.
Input parameters
Page number to fetch, must be 1 or greater
Number of webhooks per page, maximum 100
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
HELPWISE_SEARCH_CONTACTSTool to search contacts by term with pagination. Use when you need to find contacts by name, email, phone, or other contact attributes.
Input parameters
Search term to find contacts by name, email, phone, or other contact fields
Number of results per page (1-100)
Offset for pagination (starting from 0)
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
HELPWISE_UPDATE_CONTACTTool to update an existing Helpwise contact. Use when you need to modify contact details or custom attributes.
Input parameters
Full name of the contact
Email address of the contact
Phone number of the contact
The unique identifier of the contact to update
Organization or company name of the contact
A dictionary of custom key-value attributes for the contact
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
HELPWISE_UPDATE_MAILBOXUpdates an existing Helpwise mailbox. Use this action to modify mailbox settings such as display name, email address, team assignment, email signature, or default status. At least one field must be provided for update. Obtain the mailbox_id from the Get Mailboxes action.
Input parameters
New display name for the mailbox. If provided, updates the mailbox's visible name.
Email address associated with the mailbox. Updates the email address used for this mailbox.
Team ID to assign this mailbox to. Use the Get Teams action to retrieve valid team IDs.
Email signature to append to outgoing emails from this mailbox. Supports multi-line text.
Set to true to make this the default mailbox for sending emails, or false to remove default status.
Unique identifier of the mailbox to update. Can be obtained from the Get Mailboxes 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
HELPWISE_UPDATE_MESSAGETool to update an existing message. Use when you need to modify message content by its ID.
Input parameters
Updated content of the message
Unique identifier of the message 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
HELPWISE_UPDATE_TAGUpdates an existing tag's name and/or color in Helpwise. Use this action when you need to rename a tag or change its visual appearance. You must have the tag's ID before calling this action - obtain it using HELPWISE_GET_TAG or from the Helpwise UI.
Input parameters
Updated name for the tag. This will replace the existing tag name.
Optional hex color code for the tag (e.g., #FF0000 for red, #00FF00 for green). If not provided, the existing color will be preserved.
Unique identifier of the tag to update. Obtain this from HELPWISE_GET_TAG or by listing tags through the Helpwise 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
HELPWISE_UPDATE_TEMPLATEUpdates an existing Helpwise email template by modifying its name, subject, and/or HTML content. Use this action when you need to: - Change the display name of a template - Update the subject line (including placeholders) - Modify the HTML content/body of the template Prerequisites: - You must have the template_id (obtain via Get Templates action or Helpwise UI) - At least one field (name, subject, or html) must be provided for update Note: This action performs a partial update - only provided fields will be modified.
Input parameters
Updated HTML content/body of the template. Supports placeholders like {{variable_name}}. If not provided, the existing content will remain unchanged.
New display name for the template. If not provided, the existing name will remain unchanged.
New subject line for emails sent using this template. Supports placeholders like {{customer_name}}. If not provided, the existing subject will remain unchanged.
Unique identifier of the template to update. Obtain this from the Get Templates action or from the Helpwise 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
No publicly available marketplace agent is found using this tool yet. There are 53 agents privately built on Nagent that already use Helpwise.
Build on Nagent
Connect Helpwise 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 Helpwise, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Helpwise is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Helpwise is connected, you configure its 37 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Helpwise 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 Helpwise event fires, the agent kicks off automatically.
Every Helpwise 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 Helpwise ships with 37 pre-built customer support actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Helpwise together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Helpwise-based workflows tailored to your business.