Lemon Squeezy is a platform designed to simplify payments, taxes, and subscriptions for software companies, offering a powerful API and webhooks for seamless integration.
Lemon Squeezy is a platform designed to simplify payments, taxes, and subscriptions for software companies, offering a powerful API and webhooks for seamless integration. On Nagent, Lemon Squeezy is exposed as a fully-configurable ecommerce integration that any agent can call — 32 actions, and API key authentication. No code is required to wire Lemon Squeezy into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Lemon Squeezy to automate the kinds of tasks ecommerce 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 Lemon Squeezy 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 Lemon Squeezy, with input parameters and output schema. Drop these into any step of an agent built in Helix.
LEMON_SQUEEZY_CREATE_CUSTOMERTool to create a new customer. Use after verifying the store exists and you need to add a customer to it. Example: "Create a customer John Doe with email johndoe@example.com in store 1."
Input parameters
The customer resource data object.
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
LEMON_SQUEEZY_CREATE_DISCOUNTTool to create a new discount code in Lemon Squeezy. Use when you need to create promotional discounts for products or subscriptions. Example: "Create a discount code SUMMER20 with 20% off in store 123."
Input parameters
The discount resource data object.
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
LEMON_SQUEEZY_CREATE_WEBHOOKTool to create a new webhook for receiving event notifications. Use when you need to register a webhook endpoint to receive events like order_created, subscription_created, etc. Specify the webhook URL, signing secret, and event types to subscribe to.
Input parameters
Main data object for webhook 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
LEMON_SQUEEZY_DELETE_DISCOUNTTool to delete a discount by its ID. Use when you need to permanently remove a discount from a store.
Input parameters
The ID of the discount 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
LEMON_SQUEEZY_DELETE_WEBHOOKTool to delete a webhook. Use when you need to remove a registered webhook endpoint.
Input parameters
The ID of the 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
LEMON_SQUEEZY_LIST_ALL_AFFILIATESTool to list all affiliates. Use when you need to retrieve affiliates with optional filters and pagination.
Input parameters
Sort order: 'createdAt' ascending or '-createdAt' descending.
Filter affiliates by the ID of the store they belong to.
Number of affiliates per page (1-100).
Filter affiliates by user email.
Page number for pagination, starting at 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
LEMON_SQUEEZY_LIST_ALL_CHECKOUTSTool to list all checkouts. Use when you need a paginated list of checkouts, optionally filtering by store or variant.
Input parameters
Only return checkouts belonging to the store with this ID.
Only return checkouts belonging to the variant with this 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
LEMON_SQUEEZY_LIST_ALL_CUSTOMERSRetrieves a paginated list of all customers from your Lemon Squeezy store(s). Returns customer details including email, name, location, revenue metrics (MRR, total revenue), marketing status, and relationships to orders, subscriptions, and license keys. Use this action to: - Get all customers across stores or filter by specific store_id - Find a customer by email address - List customers with pagination support (default 10 per page, max 100) - Access customer portal URLs and relationship links All parameters are optional. Without filters, returns all customers ordered by creation date (newest first).
Input parameters
Filter customers by email address.
Filter customers by the ID of the store to which they belong.
Number of customers per page (1-100).
Page number for pagination (starting at 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
LEMON_SQUEEZY_LIST_ALL_DISCOUNT_REDEMPTIONSTool to list all discount redemptions. Use when you need a paginated list of discount redemptions, optionally filtering by discount or order.
Input parameters
Return discount redemptions that belong to the order with this ID.
Number of items per page (1-100)
Return discount redemptions that belong to the discount with this ID.
Page number for pagination (starting at 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
LEMON_SQUEEZY_LIST_ALL_DISCOUNTSTool to list all discounts. Use when you need a paginated list of discounts after confirming authentication.
Input parameters
Filter discounts by store ID. Only return discounts belonging to the specified store.
Number of discounts per page (1-100)
Page number for pagination (starting at 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
LEMON_SQUEEZY_LIST_ALL_FILESRetrieves a paginated list of files from Lemon Squeezy. Use this to get digital goods that can be downloaded by customers after purchase. Each file belongs to a variant and includes download URLs (signed, expiring after 1 hour, rate-limited to 10 downloads/day/IP). Filter by variant ID or control pagination with page number and size.
Input parameters
Comma-separated list of related resources to include (e.g., 'variant').
Number of items per page (1-100).
Filter files by variant ID. Only returns files associated with the specified variant.
Page number to retrieve (starting at 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
LEMON_SQUEEZY_LIST_ALL_LICENSE_KEY_INSTANCESTool to list all license key instances. Use when you need a paginated list of license key instances, optionally filtering by license key ID.
Input parameters
Number of instances per page (1-100).
Page number for pagination (starting at 1).
Filter instances by the ID of the license key they belong 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
LEMON_SQUEEZY_LIST_ALL_LICENSE_KEYSTool to list all license keys. Use when you need a paginated list of license keys, optionally filtering by store, order, order item, or product.
Input parameters
Comma-separated list of related resources to include (e.g., 'store,customer,order').
Filter license keys by order ID.
Filter license keys by store ID.
Number of license keys per page (1-100).
Filter license keys by product ID.
Page number for pagination (starting at 1).
Filter license keys by order item 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
LEMON_SQUEEZY_LIST_ALL_ORDER_ITEMSTool to list all order items. Use when you need a paginated list of order items, optionally filtered by order, product, or variant. Note: the `first_order_item` field on an order object returns only one item; use `filter_order_id` here to retrieve all line items for multi-item orders.
Input parameters
Number of order items per page (1-100)
Page number for pagination (starting at 1)
Filter order items by order ID
Filter order items by product ID
Filter order items by variant 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
LEMON_SQUEEZY_LIST_ALL_ORDERSTool to list all orders. Use when you need a paginated list of orders, optionally filtering by store or user email. Monetary fields (e.g., `subtotal`, `tax`, `total`) are integers in the smallest currency unit (e.g., cents); use `*_formatted` variants for display only, not calculations.
Input parameters
Return only orders belonging to the store with this ID. Omitting this in multi-store setups returns orders across all stores, which can corrupt aggregations.
Number of orders per page (1-100)
Return only orders where the `user_email` field matches this email address.
Page number for pagination (starting at 1) Check `meta.page` in the response to determine whether additional pages exist.
Return only the order with this specific order number.
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
LEMON_SQUEEZY_LIST_ALL_PRICESTool to list all prices. Use when you need a paginated list of all prices, optionally filtering by variant.
Input parameters
Number of prices per page (1-100)
Return only prices associated with the variant with this ID.
Page number for pagination (starting at 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
LEMON_SQUEEZY_LIST_ALL_PRODUCTSList all products from your Lemon Squeezy store with pagination and filtering. Returns a paginated list of products ordered by name. Each product includes pricing, status, thumbnails, checkout URLs, and metadata. Useful for browsing your product catalog, checking product details, or filtering by store.
Input parameters
Filter products by store ID (optional)
Number of products per page (1-100, default: 10)
Page number to retrieve (default: 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
LEMON_SQUEEZY_LIST_ALL_STORESRetrieves a paginated list of all stores belonging to the authenticated Lemon Squeezy account. This action returns comprehensive store information including store details (name, slug, domain, URL), financial metrics (total sales/revenue, 30-day sales/revenue), configuration (plan, country, currency), and relationship links to associated resources (products, orders, subscriptions, discounts, license keys, webhooks, and affiliates). Returns stores ordered by name in ascending order with pagination metadata. No input parameters required. Use this as a starting point to discover available stores before working with other store-specific resources.
Input parameters
Number of results per page. Default: 10, max: 100.
Page number to retrieve. Default: 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
LEMON_SQUEEZY_LIST_ALL_SUBSCRIPTION_INVOICESTool to list all subscription invoices. Use when you need a paginated list of subscription invoices with optional filters.
Input parameters
Filter invoices by status
Filter invoices by refunded state (true/false)
Filter invoices by store ID
Number of items per page (1-100)
Page number for pagination (starting at 1)
Filter invoices by subscription 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
LEMON_SQUEEZY_LIST_ALL_SUBSCRIPTION_ITEMSTool to list all subscription items. Use when you need a paginated list of items across subscriptions for reporting or auditing.
Input parameters
Filter subscription items by the ID of the price.
Number of items per page (1-100)
Page number for pagination (starting at 1)
Filter subscription items by the ID of the subscription they belong 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
LEMON_SQUEEZY_LIST_ALL_SUBSCRIPTIONSTool to list all subscriptions. Use when you need a paginated list of subscriptions, optionally filtered by store, order, product, or status.
Input parameters
Return only subscriptions with this status (e.g., 'active', 'cancelled').
Return only subscriptions belonging to the order with this ID.
Return only subscriptions belonging to the store with this ID.
Number of subscriptions per page (1-100).
Return only subscriptions belonging to the product with this ID.
Return only subscriptions where the user_email matches this address.
Return only subscriptions belonging to the variant with this ID.
Page number for pagination (starting at 1).
Return only subscriptions belonging to the order item with this 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
LEMON_SQUEEZY_LIST_ALL_USAGE_RECORDSRetrieves all usage records from Lemon Squeezy, with optional filtering and pagination. Usage records track consumption for usage-based billing on subscription items. Each record represents reported usage with a quantity and action type (increment or set). Records are returned in descending order by creation date (newest first). Use this when you need to: - View all usage records across subscription items - Filter usage records for a specific subscription item - Paginate through large sets of usage records Note: Returns an empty list if no usage records exist or the filter matches nothing.
Input parameters
Number of usage records to return per page. Must be between 1 and 100. Default is 10 if not specified.
The page number to retrieve, starting from 1. Default is 1 if not specified.
Filter to only show usage records belonging to this subscription item ID. Omit to retrieve usage records from all subscription 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
LEMON_SQUEEZY_LIST_ALL_VARIANTSRetrieves a paginated list of product variants from Lemon Squeezy. A variant represents a variation of a product with its own pricing options, files, and license key settings. You can filter by product ID and status (pending/draft/published), and control pagination with page number and size.
Input parameters
Return only variants with the given status. One of 'pending', 'draft', or 'published'.
Number of items per page (1-100).
Return only variants associated with this product ID.
Page number to return (starting at 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
LEMON_SQUEEZY_LIST_ALL_WEBHOOKSTool to list all webhooks. Use when you need to retrieve registered webhooks. Supports optional filtering by store ID and pagination parameters for controlling result size and navigation.
Input parameters
Only return webhooks belonging to the store with this ID.
Number of webhooks per page (1-100).
Page number to retrieve (starting from 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
LEMON_SQUEEZY_RETRIEVE_AUTHENTICATED_USERTool to retrieve the currently authenticated user from Lemon Squeezy. Use when you need to get details about the user associated with the current API key, including their name, email, avatar, and account 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
LEMON_SQUEEZY_RETRIEVE_CUSTOMERTool to retrieve a specific customer by their ID. Use when you need detailed information about a single customer including their email, name, location, revenue metrics, and relationships to orders and subscriptions.
Input parameters
The ID of the customer 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
LEMON_SQUEEZY_RETRIEVE_DISCOUNTTool to retrieve a single discount by ID. Use when you need details about a specific discount.
Input parameters
The ID of the discount 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
LEMON_SQUEEZY_RETRIEVE_STORETool to retrieve a store by its ID. Use when you need to get detailed information about a specific store. Returns comprehensive store data including financial metrics, configuration, and related resource links.
Input parameters
The ID of the store 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
LEMON_SQUEEZY_RETRIEVE_WEBHOOKTool to retrieve a webhook by its ID. Use when you need to get details of a specific webhook configuration.
Input parameters
The unique identifier of the webhook 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
LEMON_SQUEEZY_UPDATE_CUSTOMERTool to update an existing customer with the given ID. Use when you need to modify customer details like name, email, or address information. At least one attribute field must be provided to update.
Input parameters
The ID of the customer to update
The city of the customer
The full name of the customer
The email of the customer
The region/state of the customer
ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB', 'DE')
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
LEMON_SQUEEZY_UPDATE_WEBHOOKTool to update an existing webhook. Use when you need to modify the URL, events, or secret for a registered webhook.
Input parameters
Data wrapper for the webhook update request.
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
LEMON_SQUEEZY_VALIDATE_LICENSETool to validate a license key and optionally a specific license key instance. Use when you need to check if a license key is valid and active.
Input parameters
Optionally validate a specific license key instance. If provided, validates the instance; if omitted, validates the license key and returns 'instance': null in response.
The license key to validate
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 36 agents privately built on Nagent that already use Lemon Squeezy.
Build on Nagent
Connect Lemon Squeezy 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 Lemon Squeezy, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Lemon Squeezy is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Lemon Squeezy is connected, you configure its 32 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Lemon Squeezy 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 Lemon Squeezy event fires, the agent kicks off automatically.
Every Lemon Squeezy 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 Lemon Squeezy ships with 32 pre-built ecommerce actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Lemon Squeezy together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Lemon Squeezy-based workflows tailored to your business.