Beautifully simple KPI software. Create, manage and analyse your Key Performance Indicators from the cloud.
Beautifully simple KPI software. Create, manage and analyse your Key Performance Indicators from the cloud. On Nagent, Simplekpi is exposed as a fully-configurable analytics integration that any agent can call — 51 actions, and BASIC authentication. No code is required to wire Simplekpi into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Simplekpi to automate the kinds of tasks analytics 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 Simplekpi 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 Simplekpi, with input parameters and output schema. Drop these into any step of an agent built in Helix.
SIMPLEKPI_ADD_USER_GROUP_ITEMTool to assign a group item to a user in SimpleKPI. Use when you need to add a group item to a specific user's profile.
Input parameters
The group item identifier to assign to the user.
The identifier of the user to assign the group item 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
SIMPLEKPI_ADD_USER_KPITool to assign a KPI to a user in SimpleKPI. Use when you need to link a KPI to a specific user with optional custom target and display order.
Input parameters
KPI ID to assign to the user
User ID to assign the KPI to
Display order of the KPI on the KPI Entry screen for this user
User-specific target value for this KPI (optional). Overrides the default KPI target for this user
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
SIMPLEKPI_CREATE_CATEGORY_KPITool to create a new KPI within a category in SimpleKPI. Use when you need to add a new performance indicator to track metrics like sales, revenue, or customer satisfaction.
Input parameters
Name of the KPI (maximum 100 characters)
The ID of the icon to use for this KPI
The ID of the unit of measurement for this KPI
Whether the KPI is active and visible
Display order position for this KPI within the category
The ID of the category where the KPI will be created
Frequency ID as a single uppercase letter: D (daily), W (weekly), M (monthly), Q (quarterly), Y (yearly)
Indicates whether higher (U) or lower (D) values are better, or if direction doesn't matter (N)
Function to use when aggregating KPI values: AVG (average) or SUM (sum)
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
SIMPLEKPI_CREATE_GROUPTool to create a new group in SimpleKPI. Use when you need to organize KPIs or users into logical groups for better organization and reporting.
Input parameters
Group name. Must not exceed 50 characters.
Display order for the group. Lower values appear first in lists.
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
SIMPLEKPI_CREATE_GROUP_ITEMTool to create a new item within a group in SimpleKPI. Use when you need to add a new item to an existing group for organizing KPIs or data.
Input parameters
The name of the group item (maximum 100 characters)
The ID of the group to create the item in
The display order of the item within the group
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
SIMPLEKPI_CREATE_KPITool to create a new KPI with specified configuration. Use when you need to add a new Key Performance Indicator to track metrics.
Input parameters
Name of the KPI.
Icon ID for the KPI display.
Unit ID that defines the measurement unit for this KPI.
Active status indicating whether the KPI is currently active.
Display order for sorting KPIs in the interface.
KPI Category ID. Use GET /api/kpicategories to fetch available categories.
Frequency ID that determines data entry frequency (e.g., 'M' for monthly, 'W' for weekly, 'D' for daily).
Direction indicator: 'U' (up is good), 'D' (down is good), or 'N' (neutral).
Calculation method for aggregating KPI values: 'AVG' (average) or 'SUM' (sum).
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
SIMPLEKPI_CREATE_KPI_CATEGORYTool to create a new KPI category in SimpleKPI. Use when you need to organize KPIs into logical groups or categories.
Input parameters
Category name (maximum 50 characters)
Display order for the category (integer value)
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
SIMPLEKPI_CREATE_KPI_UNITTool to create a new KPI unit in SimpleKPI. Use when you need to define a measurement unit for KPI tracking.
Input parameters
Unit name (maximum 25 characters)
Entry format for the unit (maximum 25 characters). Use '###' as placeholder for numeric values
Whether the unit represents a percentage value
Display format for the unit (maximum 25 characters). Use '###' as placeholder for numeric values
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
SIMPLEKPI_CREATE_OR_UPDATE_KPI_ENTRIESTool to batch create or update multiple KPI entries at once. Use when you need to load multiple KPI data points efficiently (up to 5000 entries per batch). Each entry must have a kpi_id, entry_date, and either email or user_id.
Input parameters
Array of KPI entry objects to create or update. Maximum 5000 entries per batch
Indicates whether the batch contains notes. Helps optimize processing
Indicates whether the batch contains actual values. Helps optimize processing
Indicates whether the batch contains target values. Helps optimize processing
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
SIMPLEKPI_CREATE_USERTool to create a new user account in SimpleKPI. Use when you need to add a new user with specific permissions and access levels.
Input parameters
Valid email address for login
Password for new user. Must be at least 8 characters long
Last name of user (optional)
User type: Admin, Director, Manager, or User
First name of user
User status: A for Active or L for Locked
Whether user can manage other users. Relevant for Manager type
Whether user can access admin settings. Relevant for Admin type
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
SIMPLEKPI_DELETE_CATEGORY_KPITool to delete a KPI from a category. Use when you need to remove a specific KPI from a category.
Input parameters
The ID of the KPI to delete from the category
The ID of the category containing the KPI
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
SIMPLEKPI_DELETE_GROUPTool to delete a group by ID. Use when you need to permanently remove a group from the system.
Input parameters
Group ID 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
SIMPLEKPI_DELETE_GROUP_ITEMTool to delete a group item by ID. Use when you need to remove an item from a specific group.
Input parameters
The ID of the group item to delete
The ID of the group containing the item 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
SIMPLEKPI_DELETE_KPITool to delete a KPI by ID. Use when you need to permanently remove a specific KPI from the system.
Input parameters
The unique identifier of the KPI 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
SIMPLEKPI_DELETE_KPI_CATEGORYTool to delete a KPI category by its ID. Use when you need to remove a KPI category from the system.
Input parameters
The unique identifier of the KPI category 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
SIMPLEKPI_DELETE_KPI_ENTRYTool to delete a KPI entry by ID. Use when you need to permanently remove a specific KPI entry from the system.
Input parameters
The unique identifier of the KPI entry 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
SIMPLEKPI_DELETE_KPI_UNITTool to delete a KPI unit by its ID. Use when you need to remove a KPI unit from the system.
Input parameters
The unique identifier of the KPI unit 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
SIMPLEKPI_DELETE_USERTool to delete a user account by ID. Use when you need to permanently remove a user from the system.
Input parameters
User ID 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
SIMPLEKPI_DELETE_USER_GROUP_ITEMTool to remove a group item assignment from a user. Use when you need to unassign a specific group item from a user.
Input parameters
Group item ID to remove from the user.
User ID to remove the group item assignment 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
SIMPLEKPI_DELETE_USER_KPITool to remove a KPI assignment from a user. Use when you need to unassign or delete a specific KPI from a user's profile.
Input parameters
The ID of the KPI assignment to remove from the user
The ID of the user from whom to remove the KPI assignment
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
SIMPLEKPI_GET_ALL_DATA_ENTRIESTool to retrieve processed KPI data entries for reports including calculated KPIs. Use when you need comprehensive report data with KPI metrics, targets, and metadata. Returns up to 10,000 entries with details like kpiId, kpiName, itemName, period, actual, target, and notes.
Input parameters
End date for filtering entries in YYYY-MM-DD format. Defaults to today if not provided
Comma-separated list of KPI IDs to filter entries (e.g., '1,2,3'). If not provided, returns entries for all KPIs
Comma-separated list of user IDs to filter entries (e.g., '5,15,25'). Filters by specific users
Start date for filtering entries in YYYY-MM-DD format. Defaults to today if not provided
Comma-separated list of group item IDs to filter entries (e.g., '10,20,30'). Filters by specific group items
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
SIMPLEKPI_GET_CATEGORY_KPITool to retrieve a specific KPI within a category. Use when you need detailed information about a particular KPI including its name, description, target values, and configuration settings.
Input parameters
The ID of the KPI to retrieve.
The ID of the category containing the KPI.
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
SIMPLEKPI_GET_GROUPTool to get a specific group by ID from SimplekPI. Use when you need to retrieve detailed information about a particular group.
Input parameters
The unique identifier of the group 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
SIMPLEKPI_GET_GROUP_ITEMTool to retrieve a specific group item by ID. Use when you need to fetch details of a particular item within a group.
Input parameters
The unique identifier of the item to retrieve.
The identifier of the group containing the item.
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
SIMPLEKPI_GET_KPITool to retrieve a specific KPI by ID from SimpleKPI. Use when you need detailed information about a particular KPI including its configuration, targets, and metadata.
Input parameters
The unique identifier of the KPI 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
SIMPLEKPI_GET_KPI_CATEGORYTool to get a specific KPI category by ID from SimpleKPI. Use when you need to retrieve detailed information about a particular KPI category.
Input parameters
The unique identifier of the KPI category 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
SIMPLEKPI_GET_KPI_ENTRYTool to retrieve a specific KPI entry by ID. Use when you need to fetch detailed information about a particular KPI entry including actual values, targets, notes, and timestamps.
Input parameters
The unique identifier of the KPI entry 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
SIMPLEKPI_GET_KPI_FREQUENCYTool to get a specific KPI frequency by ID from SimplekPI. Use when you need to retrieve information about a particular frequency setting for KPIs.
Input parameters
The frequency ID (e.g., 'D' for Daily, 'W' for Weekly, 'M' for Monthly)
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
SIMPLEKPI_GET_KPI_ICONTool to retrieve a specific KPI icon by ID. Use when you need to get icon details including the icon name which can be used to construct the icon URL.
Input parameters
The unique identifier of the KPI icon 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
SIMPLEKPI_GET_KPI_UNITTool to get a specific KPI unit by ID from SimpleKPI. Use when you need to retrieve detailed information about a particular KPI unit including its format specifications and metadata.
Input parameters
The unique identifier of the KPI unit 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
SIMPLEKPI_GET_USERTool to retrieve a specific user by ID. Use when you need to get details about a particular user account.
Input parameters
The unique user ID 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
SIMPLEKPI_GET_USER_GROUP_ITEMTool to get a specific group item assigned to a user. Use when you need to retrieve details of a particular group item for a user.
Input parameters
The identifier of the group item to retrieve
The identifier of the user
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
SIMPLEKPI_GET_USER_KPITool to retrieve a specific KPI assigned to a user. Use when you need details about a particular KPI assignment for a user.
Input parameters
The ID of the KPI assigned to the user.
The ID of the user.
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
SIMPLEKPI_LIST_CATEGORY_KPISTool to retrieve all KPIs within a specific category. Use when you need to list or inspect KPIs belonging to a particular category.
Input parameters
The ID of the category to retrieve KPIs 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
SIMPLEKPI_LIST_GROUP_ITEMSTool to get all items within a group. Use when you need to retrieve the complete list of items belonging to a specific group.
Input parameters
The identifier of the group containing the items
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
SIMPLEKPI_LIST_GROUPSTool to retrieve all groups from SimpleKPI. Use when you need to list groups for organizing users and company hierarchy.
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
SIMPLEKPI_LIST_KPI_CATEGORIESTool to get all KPI categories. Use when you need to retrieve the complete list of KPI categories for organizing KPIs.
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
SIMPLEKPI_LIST_KPI_ENTRIESTool to get all KPI entries filtered by date range and optional criteria. Use when you need to retrieve KPI data for analysis or reporting. Returns a maximum of 500 entries per page. Use pagination parameters (rows, page) to retrieve additional entries.
Input parameters
Page number for pagination (starts at 1)
Maximum number of entries to return per page (max 500)
Filter by specific KPI ID to get entries only for that KPI
End date for filtering KPI entries in YYYY-MM-DD format
Filter by specific user ID to get entries only for that user
Start date for filtering KPI entries 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
SIMPLEKPI_LIST_KPI_FREQUENCIESTool to get all KPI frequencies. Use when you need to retrieve available data entry frequency options (Daily, Weekly, Monthly, etc.) for KPI configuration.
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
SIMPLEKPI_LIST_KPI_ICONSTool to retrieve all KPI icons from SimpleKPI. Use when you need to get available icons for display purposes or to help identify KPIs.
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
SIMPLEKPI_LIST_KPISTool to retrieve all KPIs from a SimpleKPI account. Use when you need to list all available KPIs with their configurations, targets, and metadata.
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
SIMPLEKPI_LIST_KPI_UNITSTool to retrieve all KPI units from a SimpleKPI account. Use when you need to list available units that describe how KPI values are displayed (currency, percentage, etc.).
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
SIMPLEKPI_LIST_USER_GROUP_ITEMSTool to get all group items assigned to a user. Use when you need to retrieve group assignments for a specific user in SimpleKPI.
Input parameters
The ID of the user to retrieve group items 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
SIMPLEKPI_LIST_USER_KPISTool to get all KPIs assigned to a specific user. Use when you need to retrieve what KPIs a user can enter data against and analyze.
Input parameters
User ID to retrieve KPIs 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
SIMPLEKPI_UPDATE_CATEGORY_KPITool to update a KPI within a category. Use when you need to modify KPI details such as name, target, frequency, or aggregation method.
Input parameters
KPI ID to update
KPI name (max 100 characters)
Icon identifier for the KPI
Unit of measure identifier
Determines if data entry is permitted for this KPI
Display ordering position
Category ID containing the KPI
KPI description (max 150 characters)
Data entry frequency: W (Weekly), D (Daily), M (Monthly), Q (Quarterly), or Y (Yearly)
Default target value for the KPI
Direction indicator: U (Up), D (Down), or N (None)
Calculation method: AVG (Average) or SUM (Sum)
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
SIMPLEKPI_UPDATE_GROUPTool to update an existing group in SimpleKPI. Use when you need to modify a group's name or display order.
Input parameters
The unique ID of the group to update.
The new name for the group (max 50 characters).
The display order for the group. Lower values appear 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
SIMPLEKPI_UPDATE_GROUP_ITEMTool to update an existing item in a SimpleKPI group. Use when you need to modify the name or sort order of a group item. Requires both group_id and item id to identify the item to update. Both name and sort_order must be provided.
Input parameters
The unique identifier of the item to update.
The new name for the item. Maximum length is 50 characters.
The unique identifier of the group containing the item.
The display order of the item. Must be a 16-bit integer (range: -32768 to 32767).
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
SIMPLEKPI_UPDATE_KPITool to update an existing KPI in SimpleKPI. Use when you need to modify KPI properties such as name, description, target values, or settings.
Input parameters
KPI ID to update
KPI name (maximum 100 characters)
Icon identifier for the KPI
Unit of measure identifier
Activation status for data entry. Set to true to enable data entry, false to disable.
Display order ranking for the KPI
KPI Category ID that this KPI belongs to
KPI description (maximum 150 characters)
Data entry frequency (D=Daily, W=Weekly, M=Monthly, Q=Quarterly, Y=Yearly). Case-sensitive, must be uppercase.
Default target value for the KPI
Direction indicator: U(p) means higher is better, D(own) means lower is better, N(one) means no direction
How the KPI is calculated: AVG (Average) or SUM (Total Sum)
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
SIMPLEKPI_UPDATE_KPI_ENTRYTool to update an existing KPI entry in SimpleKPI. Use when modifying entry values, targets, or notes for a specific KPI entry. At least one of actual, target, or notes must be provided (actual cannot be null if both target and notes are null).
Input parameters
The note associated with the KPI entry (max 500 characters)
The actual value. Cannot be null if the target and notes are both null
The KPI must be active and cannot be a calculated KPI. The KPI must also be assigned to the user
The target value of the entry. This value will be ignored if the KPI has a null target
An ID of an active user to assign to the KPI entry
The date of the entry. Date time format without timezone, e.g. '2019-01-01T00:00:00'
The ID of the KPI entry to update (required)
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
SIMPLEKPI_UPDATE_KPI_UNITTool to update an existing KPI unit in SimpleKPI. Use when you need to modify unit properties such as name, entry format, display format, or percentage status.
Input parameters
The unit ID to update
The name of the KPI unit (maximum 25 characters)
The entry format is only for entry and will not have the prefix or suffix (e.g., #.00). Maximum 25 characters.
To determine if the value is a percentage as these values are treated differently
The display format must be a valid number format (e.g., £ #.00). Maximum 25 characters.
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
SIMPLEKPI_UPDATE_USERTool to update an existing user account in SimpleKPI. Use when you need to modify user details such as type, status, name, or permissions.
Input parameters
User ID to update
Email address of the user
Last name of the user
User type (e.g., 'Standard', 'Manager', 'Director')
First name of the user
User status ID. Use 'A' for Active, 'I' for Inactive
Whether the user can manage other users. Set to true to grant user management permissions
Whether the user can access admin settings. Set to true to grant admin access
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 94 agents privately built on Nagent that already use Simplekpi.
Build on Nagent
Connect Simplekpi 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 Simplekpi, and click "Connect Now." You'll authenticate with BASIC — Nagent handles credential storage and refresh automatically. Once connected, Simplekpi is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Simplekpi is connected, you configure its 51 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Simplekpi 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 Simplekpi event fires, the agent kicks off automatically.
Every Simplekpi 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 Simplekpi ships with 51 pre-built analytics actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Simplekpi together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Simplekpi-based workflows tailored to your business.