# Lemon Squeezy

Manage Lemon Squeezy: products, variants, orders, subscriptions, license keys. Exposes **40 actions** covering the full API surface
the agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `lemonsqueezy_list_stores` | List your Lemon Squeezy stores - GET /stores. |
| `lemonsqueezy_get_store` | Get one store - GET /stores/{id}. |
| `lemonsqueezy_list_customers` | List customers in a store - GET /stores/{store_id}/customers. |
| `lemonsqueezy_get_customer` | Get one customer - GET /customers/{id}. |
| `lemonsqueezy_create_customer` | Create a customer - POST /customers. |
| `lemonsqueezy_update_customer` | Update a customer - PATCH /customers/{id}. |
| `lemonsqueezy_list_products` | List products in a store - GET /stores/{store_id}/products. |
| `lemonsqueezy_get_product` | Get one product - GET /products/{id}. |
| `lemonsqueezy_create_product` | Create a product - POST /products. |
| `lemonsqueezy_update_product` | Update a product - PATCH /products/{id}. |
| `lemonsqueezy_list_variants` | List variants of a product - GET /products/{product_id}/variants. |
| `lemonsqueezy_get_variant` | Get one variant - GET /variants/{id}. |
| `lemonsqueezy_create_variant` | Create a variant - POST /variants. |
| `lemonsqueezy_update_variant` | Update a variant - PATCH /variants/{id}. |
| `lemonsqueezy_list_orders` | List orders in a store - GET /stores/{store_id}/orders. |
| `lemonsqueezy_get_order` | Get one order - GET /orders/{id}. |
| `lemonsqueezy_create_order` | Create an order (one-time purchase) - POST /orders. |
| `lemonsqueezy_list_subscriptions` | List subscriptions in a store - GET /stores/{store_id}/subscriptions. |
| `lemonsqueezy_get_subscription` | Get one subscription - GET /subscriptions/{id}. |
| `lemonsqueezy_update_subscription` | Update a subscription (pause/resume or update card details) - PATCH /subscriptions/{id}. |
| `lemonsqueezy_cancel_subscription` | Cancel a subscription - DELETE /subscriptions/{id}. |
| `lemonsqueezy_list_invoices` | List invoices in a store - GET /stores/{store_id}/invoices. |
| `lemonsqueezy_get_invoice` | Get one invoice - GET /invoices/{id}. |
| `lemonsqueezy_list_discounts` | List discounts (coupons) in a store - GET /stores/{store_id}/discounts. |
| `lemonsqueezy_get_discount` | Get one discount - GET /discounts/{id}. |
| `lemonsqueezy_create_discount` | Create a discount/coupon - POST /discounts. |
| `lemonsqueezy_update_discount` | Update a discount - PATCH /discounts/{id}. |
| `lemonsqueezy_list_files` | List files for a variant - GET /variants/{variant_id}/files. |
| `lemonsqueezy_get_file` | Get one file - GET /files/{id}. |
| `lemonsqueezy_create_file` | Add a file to a variant - POST /files. |
| `lemonsqueezy_delete_file` | Delete a file - DELETE /files/{id}. |
| `lemonsqueezy_list_webhooks` | List webhooks for a store - GET /stores/{store_id}/webhooks. |
| `lemonsqueezy_get_webhook` | Get one webhook - GET /webhooks/{id}. |
| `lemonsqueezy_create_webhook` | Create a webhook - POST /webhooks. |
| `lemonsqueezy_update_webhook` | Update a webhook - PATCH /webhooks/{id}. |
| `lemonsqueezy_delete_webhook` | Delete a webhook - DELETE /webhooks/{id}. |
| `lemonsqueezy_list_license_keys` | List license keys in a store - GET /stores/{store_id}/license-keys. |
| `lemonsqueezy_get_license_key` | Get one license key - GET /license-keys/{id}. |
| `lemonsqueezy_list_license_key_instances` | List instances (activations) of a license key - GET /license-keys/{license_key_id}/instances. |
| `lemonsqueezy_get_license_key_instance` | Get one license key instance - GET /license-key-instances/{id}. |

## How to get credentials

This connector uses an **API key / token**. Create one in the provider
dashboard, then paste it into FlyMyAI:

- **`LEMONSQUEEZY_API_KEY`** - Lemon Squeezy - Settings - API. (https://app.lemonsqueezy.com/settings/api)

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `LEMONSQUEEZY_API_KEY` | Lemon Squeezy - Settings - API. |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the token is wrong, expired, or missing a required scope - regenerate it.
- **`429 Too Many Requests`** - you hit the provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [Lemon Squeezy API documentation](https://docs.lemonsqueezy.com/api)