SupportBee is a web-based email support tool that helps businesses organize their customer support emails efficiently.
SupportBee is a web-based email support tool that helps businesses organize their customer support emails efficiently. On Nagent, Supportbee is exposed as a fully-configurable customer support integration that any agent can call — 41 actions, and API key authentication. No code is required to wire Supportbee into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Supportbee 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 Supportbee 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 Supportbee, with input parameters and output schema. Drop these into any step of an agent built in Helix.
SUPPORTBEE_ADD_LABEL_TO_TICKETTool to add a label to a ticket. Use when you need to categorize or tag a ticket with a specific label. The label must already exist in your SupportBee account before adding it to a ticket.
Input parameters
The unique ID of the ticket to add the label to
The name of the label to add to the ticket. The label must already exist in your SupportBee 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
SUPPORTBEE_ARCHIVE_TICKETTool to archive a SupportBee ticket by its ID. Use when you want to move resolved tickets to the archive.
Input parameters
Unique identifier of the ticket to archive
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
SUPPORTBEE_ASSIGN_TICKET_TO_TEAMAssigns a ticket to a team in SupportBee. Use when you need to route a support ticket to a specific team for handling. Note: If the ticket is already assigned to a team and a user, reassigning to another team will remove the user assignee.
Input parameters
The unique ID of the team to assign the ticket to
The unique ID of the ticket to assign to a 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
SUPPORTBEE_CREATE_COMMENTCreates an internal comment on a ticket in SupportBee. Comments are private notes visible only to agents, not to customers. Use this to add internal notes, observations, or collaborate with team members on a ticket.
Input parameters
Content of the comment. Provide either text or html (or both).
The unique identifier of the ticket to add a comment to. Obtain this from list_tickets or search_tickets actions.
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
SUPPORTBEE_CREATE_CONSEQUENCECreates a new consequence for rules automation in SupportBee. Use when setting up automated actions that should be triggered by rules (e.g., auto-assign tickets, archive, or mark as spam).
Input parameters
Set to true to automatically mark the ticket as spam when this consequence is triggered
A descriptive label for the consequence to identify its purpose
Set to true to automatically archive the ticket when this consequence is triggered
Team ID to assign the ticket to. Mutually exclusive with assign_user - cannot be used together.
User ID to assign the ticket to. Mutually exclusive with assign_team - cannot be used together.
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
SUPPORTBEE_CREATE_EMAILCreate a new forwarding email address for the company in SupportBee. Use this to add new support email addresses that will forward incoming emails to your SupportBee account as tickets.
Input parameters
Display name for the email address. This name will be used when sending replies from this address.
The email address to create as a forwarding address. This is the address that will forward emails to SupportBee.
Whether to filter spam emails. When enabled, suspected spam emails will be automatically filtered.
Whether to use the agent's name instead of the company name when sending replies from this address.
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
SUPPORTBEE_CREATE_FILTERCreates a filter in SupportBee by linking a rule with a consequence. Use this after creating both a rule (defining match conditions) and a consequence (defining actions to perform).
Input parameters
ID of the rule to match. This rule defines the conditions under which the filter will be triggered. Use the Create Rule action to generate a rule and obtain its ID.
ID of the consequence to apply when the rule matches. The consequence defines the actions that will be executed when the filter conditions are met.
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
SUPPORTBEE_CREATE_RULECreates a new automation rule in SupportBee to automatically process tickets based on conditions. Rules allow you to automate ticket workflows by: - Matching tickets based on field conditions (subject, sender, body, etc.) - Automatically applying actions like labeling, archiving, assigning, or setting priority Use this after fetching available labels/teams to get valid IDs for actions. The rule will be evaluated for all new and existing tickets matching the conditions. Returns the created rule's unique ID.
Input parameters
Name of the rule to be created
Flag indicating if the rule should be active upon creation
List of one or more actions to execute when conditions match
List of one or more conditions that trigger the rule
Optional sort order for the rule, non-negative
Optional description for the rule
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
SUPPORTBEE_CREATE_SNIPPETCreate a reusable snippet (canned response) in SupportBee. Snippets are pre-written text templates that agents can quickly insert into ticket replies. Use this to create standard responses for common customer inquiries like refunds, FAQs, or welcome messages.
Input parameters
The HTML formatted content of the snippet. If not provided, the plain text will be used. Supports basic HTML formatting like <b>, <i>, <a>, <br>, etc.
The name/title for the snippet. This will be displayed when selecting snippets.
Comma-separated tags to categorize the snippet (e.g., 'refund, policy, billing').
The plain text content of the snippet. Used in text-only email 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
SUPPORTBEE_CREATE_TICKETCreates a new support ticket in SupportBee with a subject, content, and requester details. Use this action to: - Create tickets from customer inquiries or issues - Assign tickets to specific agents or teams during creation - Add tags and labels for better ticket organization - Include CC recipients to keep stakeholders informed The ticket will be created in an unanswered state and will appear in the inbox unless marked as spam.
Input parameters
Email addresses to CC on the ticket. These recipients will receive updates.
Set to true to mark the ticket as spam. Note: The API may not honor this during creation.
Tags to categorize the ticket (e.g., 'urgent', 'billing', 'bug').
Custom labels for the ticket. Use label names from your SupportBee account.
Main content/body of the ticket. Describe the issue or request in detail.
Subject line of the ticket. Should be concise and descriptive.
Team ID to assign this ticket to. Use Fetch Teams to get valid team IDs.
Agent ID to assign this ticket to. Use Fetch Teams/Users to get valid agent IDs.
Requester information. Email is required; name is optional but recommended.
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
SUPPORTBEE_CREATE_TICKET_REPLYCreate a reply to a support ticket in SupportBee. Replies are sent to customers via email and are visible to them. Use this when you need to respond to a customer's ticket with information, updates, or solutions. Provide the ticket ID and HTML-formatted content for your reply.
Input parameters
Content of the reply in HTML format
ID of the user replying; if omitted, the current user is used
ID of the ticket to reply to
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
SUPPORTBEE_CREATE_USER_OR_CUSTOMER_GROUPInvites a new user to your SupportBee account. The user will receive an email invitation and can be assigned as an agent (handles tickets), admin (full access), or collaborator (view/comment only). Use this when you need to add team members to your helpdesk programmatically.
Input parameters
Full name of the user to display in SupportBee.
Role to assign to the user. 'admin' has full account access, 'agent' can handle tickets, 'collaborator' can view and comment only. Defaults to 'agent'.
Email address of the user to invite. An invitation email will be sent to this address.
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
SUPPORTBEE_DELETE_SNIPPETPermanently delete a snippet by its ID from SupportBee. Use this action when you need to remove an unwanted or outdated snippet (canned response template). This action is destructive and cannot be undone. To find snippet IDs, use the 'Fetch Snippets' action first.
Input parameters
The unique numeric ID of the snippet to delete. You can obtain snippet IDs by calling the 'Fetch Snippets' action first.
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
SUPPORTBEE_DELETE_TICKETPermanently delete a trashed ticket from SupportBee. The ticket must first be moved to trash using the Trash Ticket action before it can be permanently deleted. Only admins can delete trashed tickets. This action is irreversible.
Input parameters
Unique numeric ID of the trashed ticket to permanently delete. The ticket must be in the trash before it can be deleted.
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
SUPPORTBEE_FETCH_EMAILSRetrieve all forwarding email addresses configured for the company. Use this tool to list the support email addresses that forward emails to SupportBee.
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
SUPPORTBEE_FETCH_LABELSTool to retrieve all custom labels. Use when you need to list labels for ticket categorization.
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
SUPPORTBEE_FETCH_SNIPPETSFetches saved response snippets (canned responses/templates) from SupportBee. Snippets are reusable text templates that can be inserted into ticket replies. Use this to list available snippets for quick responses.
Input parameters
Page of results to fetch (default is 1).
Number of snippets per page (default is 15, max is 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
SUPPORTBEE_FETCH_TEAMSRetrieves all teams in the SupportBee account. Use this to list available teams before assigning tickets to teams or filtering tickets by team. Returns team IDs, names, descriptions, and timestamps.
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
SUPPORTBEE_GET_AVG_FIRST_RESPONSE_TIME_REPORTTool to retrieve average first response time data points over time. Use when analyzing first-response performance metrics for support tickets. Returns time-series data with response times in seconds and Unix timestamps. Reports require admin API token access. Data is limited to a maximum 30-day window per request.
Input parameters
Filter data points by team ID. Only reports for the specified team will be returned.
Filter data points by agent ID. Only reports for the specified agent will be returned.
Filter data points by label name. Only tickets with this label will be included in the report.
Start of reporting period. Accepts various date formats: ISO 8601 (e.g., '2023-01-01T00:00:00Z'), YYYY-MM-DD (e.g., '2023-01-01'), or verbose formats (e.g., '15th Feb 2023'). Data points returned for max 30 days window.
End of reporting period. Accepts various date formats: ISO 8601 (e.g., '2023-01-31T23:59:59Z'), YYYY-MM-DD (e.g., '2023-01-31'), or verbose formats. Data points returned for max 30 days window.
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
SUPPORTBEE_GET_REPLIES_COUNT_REPORTRetrieves replies count report data for the company. Returns time-series data points showing the number of replies over time. The report provides aggregate metrics for the entire company account and includes type information (company/user/team), the entity ID, and the metric name. Requires admin-level API access. Use this to analyze reply volume trends and patterns.
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
SUPPORTBEE_GET_TICKETTool to retrieve a specific SupportBee ticket by its ID. Returns complete ticket details including subject, content, requester, assignee, labels, and reply/comment counts. Use when you need to fetch full details of a single ticket.
Input parameters
The unique identifier of the ticket 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
SUPPORTBEE_GET_TICKETS_COUNT_REPORTTool to get ticket count data points over time. Use when analyzing ticket volume trends within a specific date range. Supports optional filtering by agent, team, or label.
Input parameters
Filter results by label name (optional)
Filter results by team ID (optional)
End date of the report period in YYYY-MM-DD format
Filter results by agent ID (optional)
Start date of the report period in YYYY-MM-DD format
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
SUPPORTBEE_LIST_TICKET_COMMENTSRetrieves all internal comments (private agent notes) for a specific ticket. Comments are visible only to agents within the helpdesk, not to customers. Use this to review internal discussion history on a ticket.
Input parameters
The unique identifier of the ticket to retrieve comments for. Obtain this from list_tickets or search_tickets actions.
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
SUPPORTBEE_LIST_TICKET_REPLIESLists all replies on a specific support ticket in SupportBee. Returns reply content, replier details, timestamps, and attachments. Use this to view the conversation history on a ticket. Returns an empty list if the ticket has no replies yet.
Input parameters
Page number to retrieve (1-indexed). Use with per_page for paginated results.
Number of replies to return per page. Useful for pagination when a ticket has many replies.
The unique ID of the ticket to fetch replies for. Use SUPPORTBEE_LIST_TICKETS or SUPPORTBEE_SEARCH_TICKETS to find valid ticket IDs.
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
SUPPORTBEE_LIST_TICKETSTool to list tickets from SupportBee. Returns a paginated list of tickets with optional filters for spam, trash, archived, assigned user/group, labels, and more. Use when you need to retrieve and browse tickets in the helpdesk.
Input parameters
Page number for pagination (default is 1).
If true, retrieves tickets marked as spam. Defaults to false.
Filter tickets by a specific label name.
If true, retrieves tickets marked as trash. Defaults to false.
If true, filter tickets that have replies. If false, filter tickets without replies.
If true, retrieves only starred tickets.
If true, retrieves archived tickets. Defaults to false.
Number of tickets per page (default is 15, max is 100).
Return tickets with ID greater than this value.
Filter by assigned user. Use 'me' for current user, 'none' for unassigned, or provide agent ID.
Filter by assigned group/team. Use 'mine' for current user's groups or provide group 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
SUPPORTBEE_LIST_USERSRetrieves all users and customer groups in your SupportBee company. Use this when you need to list team members, filter by user type (agents/admins vs customer groups), or include invited users who haven't confirmed their accounts yet.
Input parameters
Filter users by type. Use 'user' to get only agents/admins, or 'customer_group' to get only customer groups. Omit to get all types.
If true, includes role information for each user in the response. Defaults to false.
If true, returns all agents including invited (unconfirmed) agents who haven't accepted their invitation yet. Defaults to false.
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
SUPPORTBEE_MARK_TICKET_AS_ANSWEREDMarks a SupportBee ticket as answered by adding the 'answered' status. Use this after sending a response to a customer to indicate the ticket has been addressed. This action is idempotent - calling it on an already answered ticket has no adverse effect.
Input parameters
The unique numeric ID of the ticket to mark as answered. Obtain this from list_tickets or create_ticket actions.
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
SUPPORTBEE_MARK_TICKET_AS_SPAMTool to mark a SupportBee ticket as spam. Use when you need to flag unwanted or malicious ticket submissions after obtaining the ticket ID.
Input parameters
The numeric ID of the SupportBee ticket to mark as spam. Can be provided as string or integer.
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
SUPPORTBEE_MARK_TICKET_AS_UNANSWEREDMarks a SupportBee ticket as unanswered by removing its 'answered' status. Use this to revert a ticket's status after it was previously marked as answered, typically when additional follow-up is needed from the support team. This action is idempotent - calling it on an already unanswered ticket has no adverse effect.
Input parameters
The unique numeric ID of the ticket to mark as unanswered. Obtain this from list_tickets or create_ticket actions.
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
SUPPORTBEE_REMOVE_LABEL_FROM_TICKETTool to remove a label from a ticket. Use when you need to unlabel or uncategorize a ticket by removing an existing label.
Input parameters
Unique numeric ID of the ticket to remove the label from.
Name of the label to remove from the ticket.
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
SUPPORTBEE_SEARCH_TICKETSTool to search SupportBee tickets. Use when you need to find tickets by query with pagination.
Input parameters
Page number for pagination. Defaults to 1.
If true, include tickets marked as spam. Defaults to false.
Search query string to match tickets. Searches in ticket subject, content, and requester info.
If true, include tickets that are trashed. Defaults to false.
If true, return only tickets with replies.
Filter by archived status: 'true' for only archived, 'false' for non-archived (default), 'any' to include all.
Number of tickets per page (1-100). Defaults to 15.
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
SUPPORTBEE_SHOW_TICKET_REPLYTool to fetch a specific reply for a SupportBee ticket. Use when you need details of a single reply by ticket and reply IDs.
Input parameters
ID of the reply to retrieve
ID of the ticket to fetch the reply for
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
SUPPORTBEE_SHOW_USER_OR_CUSTOMER_GROUPRetrieves details of a SupportBee user (agent/admin) or customer group by their ID. Use this action when you need to fetch profile information like name, email, role, or timestamps for a specific user whose ID you already have (e.g., from a ticket response).
Input parameters
The numeric ID of the SupportBee user or customer group. You can obtain this ID from ticket responses, team member lists, or the SUPPORTBEE_CREATE_USER_OR_CUSTOMER_GROUP 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
SUPPORTBEE_TRASH_TICKETTool to trash a SupportBee ticket by its ID. Use when you need to remove a ticket into the trash folder.
Input parameters
The numeric ID of the ticket to trash. The ticket will be moved to the trash folder.
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
SUPPORTBEE_UNARCHIVE_TICKETTool to unarchive a SupportBee ticket by its ID. Use when you need to restore an archived ticket back to active status.
Input parameters
The numeric ID of the ticket to unarchive. If the ticket is already unarchived, the operation succeeds idempotently.
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
SUPPORTBEE_UNASSIGN_TICKET_FROM_TEAMTool to un-assign a ticket from its assigned team. Use when you need to remove the current team ownership before reassigning or closing the ticket.
Input parameters
ID of the ticket to remove from its assigned 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
SUPPORTBEE_UNASSIGN_TICKET_FROM_USERTool to un-assign a ticket from its assigned user/agent. Use when you need to remove the current user ownership before reassigning to a different user or closing the ticket.
Input parameters
ID of the ticket to remove the assigned user from
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
SUPPORTBEE_UNMARK_TICKET_AS_SPAMTool to unmark a SupportBee ticket as spam. Use when a ticket was incorrectly flagged as spam.
Input parameters
The numeric ID of the SupportBee ticket to unmark as spam. Can be provided as string or integer.
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
SUPPORTBEE_UNTRASH_TICKETRestores a trashed SupportBee ticket back to active status. Use when you need to recover a ticket that was previously moved to trash.
Input parameters
The numeric ID of the trashed ticket to restore. The ticket must currently be in the trash.
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
SUPPORTBEE_UPDATE_SNIPPETUpdate an existing snippet (canned response) in SupportBee. Use this to modify the name, content, or tags of a snippet. To find snippet IDs, use the 'Fetch Snippets' action first.
Input parameters
The unique ID of the snippet to update. You can obtain snippet IDs by calling the 'Fetch Snippets' action first.
The name/title for the snippet. This will be displayed when selecting snippets.
Comma-separated tags to categorize the snippet (e.g., 'refund, policy, updated').
The content of the snippet. Must include at least text or html.
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
SUPPORTBEE_UPDATE_USERUpdate an existing SupportBee user's profile information including name, email, role, avatar, or signature. This action modifies user account details via the SupportBee API. You can update one or multiple fields in a single request. Commonly used to change user roles (agent/admin), update contact information, or customize user profiles. Requirements: - Valid user ID (obtain from SUPPORTBEE_CREATE_USER_OR_CUSTOMER_GROUP or other user-related actions) - At least one field to update (name, email, role, avatar_url, or signature) Common use cases: - Promote an agent to admin by updating the role field - Update user email addresses when they change - Customize user signatures for support ticket replies
Input parameters
The unique numeric ID of the SupportBee user to update. Required.
Updated display name for the user. If provided, replaces the current name.
Updated role for the user. Use 'agent' for regular team members or 'admin' for administrators with full permissions.
Updated email address for the user. Must be a valid email format.
Updated email signature for the user. This will appear at the end of their support replies.
URL to an image to use as the user's avatar. Must be a publicly accessible URL.
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 63 agents privately built on Nagent that already use Supportbee.
Build on Nagent
Connect Supportbee 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 Supportbee, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Supportbee is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Supportbee is connected, you configure its 41 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Supportbee 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 Supportbee event fires, the agent kicks off automatically.
Every Supportbee 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 Supportbee ships with 41 pre-built customer support actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Supportbee together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Supportbee-based workflows tailored to your business.