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

***

*Last reviewed against the provider API: September 2026.*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.