NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Segmetrics connects to a Nagent workspace with an API key. Once it is connected, agents can call 3 Segmetrics actions: "Create Product", "Add or Update Contact" and "Delete Contact". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Segmetrics, with input parameters and output schema.
SEGMETRICS_CREATE_PRODUCTTool to create a new product in SegMetrics. Use after confirming product details.
Input parameters
Unique identifier for the product.
Name of the product.
Type of product. Must be 'digital' or 'physical'.
Default price of the product, must be non-negative.
SegMetrics account ID (Site ID). Found in your SegMetrics Account settings. Format: 6+ characters starting with 'a'.
Description of the product.
External system reference ID for the product.
Integration ID to which this product belongs. Found in SegMetrics integration settings or in the URL when configuring an integration.
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
SEGMETRICS_DELETE_CONTACTTool to permanently delete a specific contact by ID or email from SegMetrics. Use after confirming the contact exists. This action is irreversible. Note: Associated invoices and purchases remain in the system.
Input parameters
SegMetrics account ID (Site ID). Found in your SegMetrics Account settings. Format: 6+ characters starting with 'a'.
Integration ID to which this contact belongs. Found in SegMetrics integration settings or in the URL when configuring an integration.
The unique identifier (contact_id) or email address of the contact to delete. Using an email will delete all contacts with that email in the integration.
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
SEGMETRICS_V1_ADD_OR_UPDATE_CONTACTTool to add or update a contact in SegMetrics. Use when you need to upsert the contact record during data import.
Input parameters
Contact's email address.
Contact status, either 'active' or 'inactive'.
UTM term parameter.
Contact's last name.
SegMetrics account ID (Site ID). Found in your SegMetrics Account settings. Format: 6+ characters starting with 'a'.
Unique identifier for the contact (string or numeric). Optional if email is provided.
Contact's first name.
UTM medium parameter.
UTM source parameter.
UTM content parameter.
Creation timestamp (YYYY-MM-DD HH:MM:SS).
Last-update timestamp (YYYY-MM-DD HH:MM:SS).
UTM campaign parameter.
Integration ID to which this contact belongs. Found in SegMetrics integration settings or in the URL when configuring an integration.
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
Agents can call 3 Segmetrics actions on Nagent: "Create Product", "Add or Update Contact" and "Delete Contact". Create Product: Create a new product in SegMetrics. Each action is listed on this page with its input parameters and its output.
Segmetrics connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Create Product takes 4 required inputs: id, name, account_id and integration_id. It also takes 4 optional inputs: type, price, description and external_id. It returns data, error and successful.