Lemon Squeezy

These are the Lemon Squeezy actions available to the apps you build with Snow. Connecting an account does not make Snow run these on its own.

• Create Customer

  Tool 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."

• Create Discount

  Tool 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."

• Create Webhook

  Tool 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.

• List All Affiliates

  Tool to list all affiliates. Use when you need to retrieve affiliates with optional filters and pagination.

• List All Checkouts

  Tool to list all checkouts. Use when you need a paginated list of checkouts, optionally filtering by store or variant.

• List All Customers

  Retrieves 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).

• List All Discount Redemptions

  Tool to list all discount redemptions. Use when you need a paginated list of discount redemptions, optionally filtering by discount or order.

• List All Discounts

  Tool to list all discounts. Use when you need a paginated list of discounts after confirming authentication.

• List All Files

  Retrieves 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.

• List All License Key Instances

  Tool to list all license key instances. Use when you need a paginated list of license key instances, optionally filtering by license key ID.

• List All License Keys

  Tool to list all license keys. Use when you need a paginated list of license keys, optionally filtering by store, order, order item, or product.

• List All Order Items

  Tool 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.

• List All Orders

  Tool 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.

• List All Prices

  Tool to list all prices. Use when you need a paginated list of all prices, optionally filtering by variant.

• List All Products

  List 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.

• List All Stores

  Retrieves 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.

• List All Subscription Invoices

  Tool to list all subscription invoices. Use when you need a paginated list of subscription invoices with optional filters.

• List All Subscription Items

  Tool to list all subscription items. Use when you need a paginated list of items across subscriptions for reporting or auditing.

• List All Subscriptions

  Tool to list all subscriptions. Use when you need a paginated list of subscriptions, optionally filtered by store, order, product, or status.

• List All Usage Records

  Retrieves 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.

• List All Variants

  Retrieves 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.

• List All Webhooks

  Tool 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.

• Retrieve Authenticated User

  Tool 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.

• Retrieve Customer

  Tool 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.

• Retrieve Discount

  Tool to retrieve a single discount by ID. Use when you need details about a specific discount.

• Retrieve Store

  Tool 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.

• Retrieve Webhook

  Tool to retrieve a webhook by its ID. Use when you need to get details of a specific webhook configuration.

• Update Customer

  Tool 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.

• Update Webhook

  Tool to update an existing webhook. Use when you need to modify the URL, events, or secret for a registered webhook.

• Validate License

  Tool 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.

• Delete Discount

  Tool to delete a discount by its ID. Use when you need to permanently remove a discount from a store.

• Delete Webhook

  Tool to delete a webhook. Use when you need to remove a registered webhook endpoint.