NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Goody connects to a Nagent workspace with an API key. Once it is connected, agents can call 13 Goody actions, such as "Create Webhook", "List All Active Cards" and "List All Active Products". 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 Goody, with input parameters and output schema.
GOODY_CALCULATE_PRICE_FOR_ORDER_BATCHCalculate price estimate for an order batch before creation. Returns per-recipient cart pricing (product, shipping, processing, tax) and total batch cost. All prices are in USD cents (e.g., 100 = $1.00). Use this to preview costs before creating an order batch.
Input parameters
Cart details (items and quantities)
List of recipients to estimate pricing for
Sending method; 'direct_send' requires mailing_address for each recipient
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
GOODY_CREATE_WEBHOOKTool to create a webhook endpoint to receive notifications about order events. Use when you need to set up automated notifications for order lifecycle events like creation, shipment, or delivery.
Input parameters
The URL for the webhook to call. This endpoint will receive POST requests with event payloads.
Filter the events you want to receive webhooks for. Valid events include: 'order_batch.created', 'order_batch.completed', 'order.created', 'order.gift_opened', 'order.gift_accepted', 'order.thank_you_note_added', 'order.shipped', 'order.delivered'. If not specified or null, all events will be sent to the webhook.
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
GOODY_DELETE_WEBHOOKDelete a webhook endpoint to stop receiving notifications from Goody API. Use this when you need to remove a webhook endpoint that is no longer needed or needs to be reconfigured. The operation returns a 204 status code on successful deletion.
Input parameters
Webhook endpoint 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
GOODY_LIST_ALL_ACTIVE_CARDSTool to list all active digital greeting cards. Use when you need to fetch available card options before sending.
Input parameters
Page number for pagination (starting from 1)
Number of items per page for pagination (1-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
GOODY_LIST_ALL_ACTIVE_PRODUCTSTool to list all active products. Use when you need to fetch available active products with pagination and filters.
Input parameters
Page index for pagination, starting from 1
Number of items per page, range 1-100
Filter products by shipping country, ISO country code
Limit to custom catalog only (approved partners)
Show inactive products in custom catalog (Commerce API custom catalogs only)
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
GOODY_LIST_ALL_ORDER_BATCHESTool to list all order batches. Use when you need to paginate through your account's order batches.
Input parameters
Page number for pagination, starting at 1
Number of items per page, between 1 and 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
GOODY_LIST_ALL_ORDERSRetrieves a paginated list of all orders across all order batches in your Goody account. Returns order details including recipient information, cart items, amounts, status, and gift links. Supports pagination with customizable page size (1-100 orders per page).
Input parameters
Page number for pagination (must be >= 1).
Number of orders to return per page (1-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
GOODY_LIST_ALL_PAYMENT_METHODSRetrieves all saved payment methods for the authenticated account. Payment methods include credit cards and other payment types that can be used when creating orders. No parameters required - simply call this action to get the complete list of payment methods with their IDs, names, and details.
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
GOODY_LIST_ALL_WORKSPACESTool to list all workspaces. Use when you need to retrieve all workspaces associated with the 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
GOODY_LIST_COLLECTIONSTool to list all collections across accessible workspaces. Use when you need to retrieve product collections available in Goody. This endpoint is limited to Automation API usage and returns paginated results.
Input parameters
Page number for pagination (must be >= 1)
Number of collections to return per page (1-100, default: 20)
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
GOODY_LIST_ORDER_ACTIVITIESTool to list all order activities (events) in your workspace. Returns a paginated list of order status transitions and related events. Use when you need to track order lifecycle events, monitor status changes, or audit order history.
Input parameters
Page number for pagination (must be >= 1).
Number of order activities to return per page (1-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
GOODY_RETRIEVE_CURRENT_USERRetrieve the current authenticated user's profile information from Goody API. This endpoint returns the email and public app ID associated with the authenticated account. Use this to verify authentication status or fetch the current user's account details. No parameters are required - authentication is handled via the Bearer token in headers.
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
GOODY_RETRIEVE_PRODUCTTool to retrieve details of a specific product by its ID. Use after obtaining the product ID.
Input parameters
Unique ID of the product
Limit to custom catalog only (approved API partners)
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 13 Goody actions on Nagent, including "Create Webhook", "List All Active Cards" and "List All Active Products". Create Webhook: Create a webhook endpoint to receive notifications about order events. Each action is listed on this page with its input parameters and its output.
Goody 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 Webhook takes 1 required input: url. It also takes 1 optional input: events. It returns data, error and successful.