> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Lemon Squeezy

> Connect Lemon Squeezy to your Atako agents — 15 read and 4 write actions.

Let your agents read stores, products, customers, orders, subscriptions and license keys, create checkout links and discount codes, and pause, resume or cancel a subscription in your Lemon Squeezy account.

## Connection

* **Authentication**: API key.

<Note>
  Sign in at app.lemonsqueezy.com → Settings → API → "+" to create a new key. Give it a name (it cannot be renamed later) and copy the key immediately — it is shown only once. A key created while the "Test mode" toggle is on only sees test-mode data.

  See [Lemon Squeezy's documentation](https://app.lemonsqueezy.com/settings/api).
</Note>

## Read actions (15)

| Action                       | Description                                                                                                                                       |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `get_current_user`           | Retrieve the user the API key belongs to (probe — no argument, works with any key).                                                               |
| `get_customer`               | Retrieve a single customer by ID.                                                                                                                 |
| `get_order`                  | Retrieve a single order by ID.                                                                                                                    |
| `get_product`                | Retrieve a single product by ID.                                                                                                                  |
| `get_store`                  | Retrieve a single store by ID.                                                                                                                    |
| `get_subscription`           | Retrieve a single subscription by ID.                                                                                                             |
| `list_customers`             | List customers, optionally filtered by store or exact email address.                                                                              |
| `list_discounts`             | List discount codes, optionally restricted to one store.                                                                                          |
| `list_license_keys`          | List license keys, optionally filtered by store, order, order item, product or status.                                                            |
| `list_orders`                | List orders, optionally filtered by store, buyer email or order number.                                                                           |
| `list_products`              | List products, optionally restricted to one store.                                                                                                |
| `list_stores`                | List the stores in the account. Use it to discover the store\_id other actions need.                                                              |
| `list_subscription_invoices` | List subscription invoices (renewal payments), optionally filtered by store, subscription, status or refunded flag.                               |
| `list_subscriptions`         | List subscriptions, optionally filtered by store, product, variant, order, subscriber email or status.                                            |
| `list_variants`              | List variants (the sellable options of a product), optionally filtered by product or status. Use it to discover the variant\_id a checkout needs. |

## Write actions (4)

| Action                | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `cancel_subscription` | Cancel a subscription. Argument: subscription\_id (string). The subscription moves to "cancelled" and stops renewing; use update\_subscription with resume true to reactivate it before it expires.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `create_checkout`     | Create a checkout and get back its payment URL (data.attributes.url). Arguments: store\_id (string, from list\_stores), variant\_id (string, from list\_variants), custom\_price (integer, amount in cents, overrides the variant price), email (string), name (string), discount\_code (string), custom (object of free-form key/value pairs echoed back on the resulting order), product\_name (string, overrides the product name on the checkout page), product\_description (string), redirect\_url (string, https URL the buyer lands on after paying), expires\_at (ISO 8601 datetime, e.g. 2026-10-30T15:20:06Z), test\_mode (boolean).                                                                                                                                         |
| `create_discount`     | Create a discount code. Arguments: store\_id (string, from list\_stores), name (string, internal label), code (string, 3 to 256 characters, uppercase letters and digits only), amount (integer — cents when amount\_type is "fixed", percentage points when it is "percent"), amount\_type ("percent" or "fixed"), duration ("once", "repeating" or "forever", default "once"), duration\_in\_months (integer, only with duration "repeating"), is\_limited\_to\_products (boolean — requires variant\_ids), variant\_ids (array of strings, the variants the code applies to), is\_limited\_redemptions (boolean), max\_redemptions (integer, only with is\_limited\_redemptions true), starts\_at and expires\_at (ISO 8601 datetimes), test\_mode (boolean).                        |
| `update_subscription` | Update a subscription: pause it, resume it, change its plan or its billing date. Arguments: subscription\_id (string), pause\_mode ("void" = no access during the pause, "free" = access kept) to pause, pause\_resumes\_at (ISO 8601 datetime, optional, with pause\_mode), resume (boolean true) to end a pause or reactivate a subscription cancelled but not yet expired, cancelled (boolean true) to cancel at the end of the current period, variant\_id (integer, bare number not a string — switches the plan), billing\_anchor (integer 1 to 31, day of the month to bill on; 0 resets it to today), trial\_ends\_at (ISO 8601 datetime), invoice\_immediately (boolean, charge a plan change straight away), disable\_prorations (boolean). Pass exactly one intent per call. |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.
