# Lemon Squeezy

> Sell software and digital products with Lemon Squeezy: make checkout links, read and refund orders, manage subscriptions, discount codes and license keys. Start a workflow on a new order or subscription.

App · 19 actions. Web page: https://docs.lodol.com/docs/integrations/lemon-squeezy

## Actions

### Cancel subscription

Cancel a subscription; the customer keeps it until the period they paid for ends.

**Inputs**

- Subscription (`subscription`, text, required): The subscription's ID, from 'List subscriptions' or the 'New subscription' trigger.

**Outputs**

- `cancelled` (true/false): True when it ends at the period's end
- `card_brand` (text): The card's brand, such as visa
- `card_last_four` (text): The card's last four digits
- `created_at` (text): When it started (ISO 8601)
- `customer_email` (text): The customer's email address
- `customer_id` (text): The customer's ID
- `customer_name` (text): The customer's name
- `customer_portal_url` (text): Where the customer manages it (works for 24 hours)
- `ends_at` (text): When a cancelled one ends (ISO 8601)
- `id` (text): The subscription's ID
- `order_id` (text): The order that started it
- `pause_mode` (text): void (keep access, no charge) or free; empty if not paused
- `paused` (true/false): True when payments are paused
- `product_id` (text): The product's ID
- `product_name` (text): The product
- `renews_at` (text): When it next renews (ISO 8601)
- `resumes_at` (text): When a pause ends (ISO 8601); empty if not set
- `status` (text): on_trial, active, paused, past_due, unpaid, cancelled or expired
- `test_mode` (true/false): True for a test-mode subscription
- `trial_ends_at` (text): When a trial ends (ISO 8601)
- `update_payment_url` (text): Where the customer updates their card (works for 24 hours)
- `variant_id` (text): The price's ID
- `variant_name` (text): The price, such as Monthly

**Example output**

```json
{
  "cancelled": true,
  "card_brand": "visa",
  "card_last_four": "4242",
  "created_at": "2026-10-27T10:00:00.000000Z",
  "customer_email": "sam@example.com",
  "customer_id": "201",
  "customer_name": "Sam Lee",
  "customer_portal_url": "https://example.lemonsqueezy.com/billing?expires=1",
  "ends_at": "2027-10-27T10:00:00.000000Z",
  "id": "301",
  "order_id": "1001",
  "pause_mode": "",
  "paused": false,
  "product_id": "10",
  "product_name": "Pro plan",
  "renews_at": "2027-10-27T10:00:00.000000Z",
  "resumes_at": "",
  "status": "cancelled",
  "test_mode": false,
  "trial_ends_at": "",
  "update_payment_url": "https://example.lemonsqueezy.com/subscription/301/payment-details",
  "variant_id": "11",
  "variant_name": "Yearly"
}
```

### Change subscription plan

Move a subscription to another product or price, such as monthly to yearly.

**Inputs**

- Subscription (`subscription`, text, required): The subscription's ID, from 'List subscriptions' or the 'New subscription' trigger.
- Product price (`variant`, text, required): The product and price to move it to.
- Charge the difference now (`charge_now`, true/false): Charge the prorated difference now rather than at the next renewal. Off by default. Default: `false`.

**Outputs**

- `cancelled` (true/false): True when it ends at the period's end
- `card_brand` (text): The card's brand, such as visa
- `card_last_four` (text): The card's last four digits
- `created_at` (text): When it started (ISO 8601)
- `customer_email` (text): The customer's email address
- `customer_id` (text): The customer's ID
- `customer_name` (text): The customer's name
- `customer_portal_url` (text): Where the customer manages it (works for 24 hours)
- `ends_at` (text): When a cancelled one ends (ISO 8601)
- `id` (text): The subscription's ID
- `order_id` (text): The order that started it
- `pause_mode` (text): void (keep access, no charge) or free; empty if not paused
- `paused` (true/false): True when payments are paused
- `product_id` (text): The product's ID
- `product_name` (text): The product
- `renews_at` (text): When it next renews (ISO 8601)
- `resumes_at` (text): When a pause ends (ISO 8601); empty if not set
- `status` (text): on_trial, active, paused, past_due, unpaid, cancelled or expired
- `test_mode` (true/false): True for a test-mode subscription
- `trial_ends_at` (text): When a trial ends (ISO 8601)
- `update_payment_url` (text): Where the customer updates their card (works for 24 hours)
- `variant_id` (text): The price's ID
- `variant_name` (text): The price, such as Monthly

**Example output**

```json
{
  "cancelled": false,
  "card_brand": "visa",
  "card_last_four": "4242",
  "created_at": "2026-10-27T10:00:00.000000Z",
  "customer_email": "sam@example.com",
  "customer_id": "201",
  "customer_name": "Sam Lee",
  "customer_portal_url": "https://example.lemonsqueezy.com/billing?expires=1",
  "ends_at": "",
  "id": "301",
  "order_id": "1001",
  "pause_mode": "",
  "paused": false,
  "product_id": "10",
  "product_name": "Pro plan",
  "renews_at": "2027-10-27T10:00:00.000000Z",
  "resumes_at": "",
  "status": "active",
  "test_mode": false,
  "trial_ends_at": "",
  "update_payment_url": "https://example.lemonsqueezy.com/subscription/301/payment-details",
  "variant_id": "11",
  "variant_name": "Yearly"
}
```

### Check license key

Check whether a license key is valid, and whose it is, as your app would.

**Inputs**

- License key (`key`, text, required): The full license key.

**Outputs**

- `activation_limit` (number): How many devices it may be used on
- `activations` (number): How many devices it is used on
- `customer_email` (text): The buyer's email address
- `error` (text): Why it isn't valid; empty when it is
- `expires_at` (text): When it expires (ISO 8601); empty if never
- `product_name` (text): The product it is for
- `status` (text): inactive, active, expired or disabled
- `store_id` (text): The store that sold it
- `valid` (true/false): True when the key is valid

**Example output**

```json
{
  "activation_limit": 3,
  "activations": 1,
  "customer_email": "sam@example.com",
  "error": "",
  "expires_at": "",
  "product_name": "Pro plan",
  "status": "active",
  "store_id": "1",
  "valid": true
}
```

### Create checkout link

Make a checkout link for a product, with the buyer's details and a discount filled in.

**Inputs**

- Store (`store`, text, required): The store selling it.
- Product price (`variant`, text, required): The product and price to sell.
- Buyer's email (`email`, text): Fill in the buyer's email address.
- Buyer's name (`name`, text): Fill in the buyer's name.
- Discount code (`discount_code`, text): Apply this discount code.
- Custom price (`custom_price`, number): Charge this instead of the usual price, in the store's currency, such as 49.00. At least 0.01.
- After paying, go to (`redirect_url`, text): Send the buyer to this address after they pay.
- Link expires (`expires_at`, date and time): When the link stops working. Leave empty for never.
- Custom data (`custom_data`, object): Fields to keep with the order, such as your own user ID; webhooks and orders carry them.
- Test mode (`test_mode`, true/false): Make it in test mode, where no real money moves. Off by default. Default: `false`.

**Outputs**

- `expires_at` (text): When it stops working (ISO 8601); empty if never
- `id` (text): The checkout's ID
- `test_mode` (true/false): True for a test-mode checkout
- `url` (text): The checkout link to send the buyer
- `variant_id` (text): The price it sells

**Example output**

```json
{
  "expires_at": "",
  "id": "5e8b546c-c561-4a2c-a586-40c18bb2a195",
  "test_mode": false,
  "url": "https://example.lemonsqueezy.com/checkout/custom/5e8b546c-c561-4a2c-a586-40c18bb2a195?signature=abc",
  "variant_id": "11"
}
```

### Create discount code

Create a discount code for a store, as a percent or an amount off.

**Inputs**

- Store (`store`, text, required): The store it works in.
- Name (`name`, text, required): What the discount is called, such as Spring sale.
- Code (`code`, text, required): The code buyers enter: 3 or more capital letters and numbers, such as SPRING20.
- Discount type (`amount_type`, text): A percent or an amount off. Defaults to a percent. One of: `percent` (Percent off), `fixed` (Amount off). Default: `percent`.
- Amount (`amount`, number, required): The percent off (20), or the amount off in the store's currency (5.00). At least 0.01.
- For subscriptions, applies to (`duration`, text): Which payments of a subscription it takes off. Defaults to the first payment only. One of: `once` (First payment only), `repeating` (A number of months), `forever` (Every payment). Default: `once`.
- Months (`months`, number): With 'A number of months', for how many months. At least 1.
- Can be used (`max_redemptions`, number): How many times it can be used in all. Leave empty for no limit. At least 1.
- Expires (`expires_at`, date and time): When it stops working. Leave empty for never.
- Test mode (`test_mode`, true/false): Make it in test mode, where no real money moves. Off by default. Default: `false`.

**Outputs**

- `amount` (number): The percent, or the amount off in the store's currency
- `amount_type` (text): percent or fixed
- `code` (text): The code buyers enter
- `duration` (text): once, repeating or forever
- `expires_at` (text): When it ends (ISO 8601)
- `id` (text): The discount's ID
- `max_redemptions` (number): How many times it can be used; 0 for no limit
- `name` (text): Its name
- `starts_at` (text): When it starts (ISO 8601)
- `status` (text): draft or published
- `test_mode` (true/false): True when it works only in test mode

**Example output**

```json
{
  "amount": 20,
  "amount_type": "percent",
  "code": "SPRING20",
  "duration": "once",
  "expires_at": "2026-12-31T23:59:59.000000Z",
  "id": "401",
  "max_redemptions": 0,
  "name": "Spring sale",
  "starts_at": "",
  "status": "published",
  "test_mode": false
}
```

### Delete discount code

Delete a discount code, so it can no longer be used.

**Inputs**

- Discount code (`discount`, text, required): The discount's ID, from 'Create discount code' or 'List discount codes'.

**Outputs**

- `deleted` (true/false): True once deleted
- `id` (text): The deleted discount's ID

**Example output**

```json
{
  "deleted": true,
  "id": "401"
}
```

### Find customers

Find customers by store or email, with what they have spent.

**Inputs**

- Store (`store`, text): Only this store's customers.
- Customer email (`email`, text): Only for this customer's email address.
- How many (`limit`, number): How many customers, newest first. Defaults to 25. From 1 to 500.

**Outputs**

- `count` (number): How many were returned
- `customers` (list): The customers
- `total` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "customers": [
    {
      "country": "US",
      "created_at": "2026-10-27T10:00:00.000000Z",
      "customer_portal_url": "https://example.lemonsqueezy.com/billing",
      "email": "sam@example.com",
      "id": "201",
      "monthly_revenue": 8.25,
      "name": "Sam Lee",
      "status": "subscribed",
      "total_revenue": 99.0
    }
  ],
  "total": 1
}
```

### Find license keys

Find the license keys sold by a store, with an order or for a product.

**Inputs**

- Store (`store`, text): Only this store's license keys.
- Order (`order`, text): Only the keys sold with this order.
- Product (`product`, text): Only for this product.
- How many (`limit`, number): How many license keys, newest first. Defaults to 25. From 1 to 500.

**Outputs**

- `count` (number): How many were returned
- `license_keys` (list): The license keys
- `total` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "license_keys": [
    {
      "activation_limit": 3,
      "activations": 1,
      "created_at": "2026-10-27T10:00:00.000000Z",
      "customer_email": "sam@example.com",
      "expires_at": "",
      "id": "501",
      "key": "38b1460a-5104-4067-a91d-77b872934d51",
      "key_short": "XXXX-77b872934d51",
      "order_id": "1001",
      "product_id": "10",
      "status": "active"
    }
  ],
  "total": 1
}
```

### Get order

Get one order: who bought what, what they paid and their receipt.

**Inputs**

- Order (`order`, text, required): The order's ID, from 'List orders' or the 'New order' trigger.

**Outputs**

- `created_at` (text): When it was placed (ISO 8601)
- `currency` (text): The currency, such as USD
- `customer_email` (text): The buyer's email address
- `customer_id` (text): The buyer's customer ID
- `customer_name` (text): The buyer's name
- `id` (text): The order's ID
- `order_number` (number): Its number in the store
- `product_id` (text): The product's ID
- `product_name` (text): The product bought
- `receipt_url` (text): The buyer's receipt
- `refunded` (true/false): True when refunded
- `refunded_amount` (number): How much was refunded
- `status` (text): pending, failed, paid, refunded, partial_refund or fraudulent
- `test_mode` (true/false): True for a test-mode order
- `total` (number): What they paid, in the store's currency
- `total_formatted` (text): What they paid, as shown, such as $11.99
- `variant_id` (text): The price's ID
- `variant_name` (text): The price bought

**Example output**

```json
{
  "created_at": "2026-10-27T10:00:00.000000Z",
  "currency": "USD",
  "customer_email": "sam@example.com",
  "customer_id": "201",
  "customer_name": "Sam Lee",
  "id": "1001",
  "order_number": 42,
  "product_id": "10",
  "product_name": "Pro plan",
  "receipt_url": "https://app.lemonsqueezy.com/my-orders/abc/receipt",
  "refunded": false,
  "refunded_amount": 0.0,
  "status": "paid",
  "test_mode": false,
  "total": 99.0,
  "total_formatted": "$99.00",
  "variant_id": "11",
  "variant_name": "Yearly"
}
```

### Get subscription

Get one subscription, with links the customer can use to manage it or update their card.

**Inputs**

- Subscription (`subscription`, text, required): The subscription's ID, from 'List subscriptions' or the 'New subscription' trigger.

**Outputs**

- `cancelled` (true/false): True when it ends at the period's end
- `card_brand` (text): The card's brand, such as visa
- `card_last_four` (text): The card's last four digits
- `created_at` (text): When it started (ISO 8601)
- `customer_email` (text): The customer's email address
- `customer_id` (text): The customer's ID
- `customer_name` (text): The customer's name
- `customer_portal_url` (text): Where the customer manages it (works for 24 hours)
- `ends_at` (text): When a cancelled one ends (ISO 8601)
- `id` (text): The subscription's ID
- `order_id` (text): The order that started it
- `pause_mode` (text): void (keep access, no charge) or free; empty if not paused
- `paused` (true/false): True when payments are paused
- `product_id` (text): The product's ID
- `product_name` (text): The product
- `renews_at` (text): When it next renews (ISO 8601)
- `resumes_at` (text): When a pause ends (ISO 8601); empty if not set
- `status` (text): on_trial, active, paused, past_due, unpaid, cancelled or expired
- `test_mode` (true/false): True for a test-mode subscription
- `trial_ends_at` (text): When a trial ends (ISO 8601)
- `update_payment_url` (text): Where the customer updates their card (works for 24 hours)
- `variant_id` (text): The price's ID
- `variant_name` (text): The price, such as Monthly

**Example output**

```json
{
  "cancelled": false,
  "card_brand": "visa",
  "card_last_four": "4242",
  "created_at": "2026-10-27T10:00:00.000000Z",
  "customer_email": "sam@example.com",
  "customer_id": "201",
  "customer_name": "Sam Lee",
  "customer_portal_url": "https://example.lemonsqueezy.com/billing?expires=1",
  "ends_at": "",
  "id": "301",
  "order_id": "1001",
  "pause_mode": "",
  "paused": false,
  "product_id": "10",
  "product_name": "Pro plan",
  "renews_at": "2027-10-27T10:00:00.000000Z",
  "resumes_at": "",
  "status": "active",
  "test_mode": false,
  "trial_ends_at": "",
  "update_payment_url": "https://example.lemonsqueezy.com/subscription/301/payment-details",
  "variant_id": "11",
  "variant_name": "Yearly"
}
```

### List discount codes

List a store's discount codes.

**Inputs**

- Store (`store`, text): Only this store's discount codes.
- How many (`limit`, number): How many discount codes, newest first. Defaults to 25. From 1 to 500.

**Outputs**

- `count` (number): How many were returned
- `discounts` (list): The discount codes
- `total` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "discounts": [
    {
      "amount": 20,
      "amount_type": "percent",
      "code": "SPRING20",
      "duration": "once",
      "expires_at": "2026-12-31T23:59:59.000000Z",
      "id": "401",
      "max_redemptions": 0,
      "name": "Spring sale",
      "starts_at": "",
      "status": "published",
      "test_mode": false
    }
  ],
  "total": 1
}
```

### List orders

List orders, newest first, for a store or a buyer's email.

**Inputs**

- Store (`store`, text): Only this store's orders.
- Customer email (`email`, text): Only for this customer's email address.
- How many (`limit`, number): How many orders, newest first. Defaults to 25. From 1 to 500.

**Outputs**

- `count` (number): How many were returned
- `orders` (list): The orders, newest first
- `total` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "orders": [
    {
      "created_at": "2026-10-27T10:00:00.000000Z",
      "currency": "USD",
      "customer_email": "sam@example.com",
      "customer_id": "201",
      "customer_name": "Sam Lee",
      "id": "1001",
      "order_number": 42,
      "product_id": "10",
      "product_name": "Pro plan",
      "receipt_url": "https://app.lemonsqueezy.com/my-orders/abc/receipt",
      "refunded": false,
      "refunded_amount": 0.0,
      "status": "paid",
      "test_mode": false,
      "total": 99.0,
      "total_formatted": "$99.00",
      "variant_id": "11",
      "variant_name": "Yearly"
    }
  ],
  "total": 1
}
```

### List products

List a store's products, each with its prices.

**Inputs**

- Store (`store`, text): Only this store's products.

**Outputs**

- `count` (number): How many were returned
- `products` (list): The products

**Example output**

```json
{
  "count": 1,
  "products": [
    {
      "buy_now_url": "https://example.lemonsqueezy.com/checkout/buy/abc",
      "id": "10",
      "name": "Pro plan",
      "price": "$9.00",
      "status": "published",
      "store_id": "1",
      "variants": [
        {
          "id": "11",
          "interval": "year",
          "is_subscription": true,
          "name": "Yearly",
          "price": 99.0,
          "status": "published"
        }
      ]
    }
  ]
}
```

### List stores

List the account's stores with their sales.

**Inputs**: None.

**Outputs**

- `count` (number): How many were returned
- `stores` (list): The stores

**Example output**

```json
{
  "count": 1,
  "stores": [
    {
      "currency": "USD",
      "domain": "example.lemonsqueezy.com",
      "id": "1",
      "name": "Example Software",
      "slug": "example",
      "total_revenue": 4158.0,
      "total_sales": 42,
      "url": "https://example.lemonsqueezy.com"
    }
  ]
}
```

### List subscriptions

List subscriptions by store, status, customer email or product.

**Inputs**

- Store (`store`, text): Only this store's subscriptions.
- Status (`status`, text): Only subscriptions in this state. Defaults to any. One of: `any` (Any status), `on_trial` (On trial), `active`, `paused`, `past_due` (Past due (a payment failed)), `unpaid`, `cancelled` (Cancelled (ends at the period's end)), `expired`. Default: `any`.
- Customer email (`email`, text): Only for this customer's email address.
- Product (`product`, text): Only for this product.
- How many (`limit`, number): How many subscriptions, newest first. Defaults to 25. From 1 to 500.

**Outputs**

- `count` (number): How many were returned
- `subscriptions` (list): The subscriptions
- `total` (number): How many match in all

**Example output**

```json
{
  "count": 1,
  "subscriptions": [
    {
      "cancelled": false,
      "card_brand": "visa",
      "card_last_four": "4242",
      "created_at": "2026-10-27T10:00:00.000000Z",
      "customer_email": "sam@example.com",
      "customer_id": "201",
      "customer_name": "Sam Lee",
      "customer_portal_url": "https://example.lemonsqueezy.com/billing?expires=1",
      "ends_at": "",
      "id": "301",
      "order_id": "1001",
      "pause_mode": "",
      "paused": false,
      "product_id": "10",
      "product_name": "Pro plan",
      "renews_at": "2027-10-27T10:00:00.000000Z",
      "resumes_at": "",
      "status": "active",
      "test_mode": false,
      "trial_ends_at": "",
      "update_payment_url": "https://example.lemonsqueezy.com/subscription/301/payment-details",
      "variant_id": "11",
      "variant_name": "Yearly"
    }
  ],
  "total": 1
}
```

### Pause subscription

Stop charging a subscription for now, until a date or until it is resumed.

**Inputs**

- Subscription (`subscription`, text, required): The subscription's ID, from 'List subscriptions' or the 'New subscription' trigger.
- While paused (`mode`, text): Keep access without charging, or give access for free. Defaults to keeping access without charging. One of: `void` (Keep access, don't charge), `free` (Give access for free). Default: `void`.
- Resume on (`resume_at`, date and time): When to start charging again. Leave empty to pause until resumed.

**Outputs**

- `cancelled` (true/false): True when it ends at the period's end
- `card_brand` (text): The card's brand, such as visa
- `card_last_four` (text): The card's last four digits
- `created_at` (text): When it started (ISO 8601)
- `customer_email` (text): The customer's email address
- `customer_id` (text): The customer's ID
- `customer_name` (text): The customer's name
- `customer_portal_url` (text): Where the customer manages it (works for 24 hours)
- `ends_at` (text): When a cancelled one ends (ISO 8601)
- `id` (text): The subscription's ID
- `order_id` (text): The order that started it
- `pause_mode` (text): void (keep access, no charge) or free; empty if not paused
- `paused` (true/false): True when payments are paused
- `product_id` (text): The product's ID
- `product_name` (text): The product
- `renews_at` (text): When it next renews (ISO 8601)
- `resumes_at` (text): When a pause ends (ISO 8601); empty if not set
- `status` (text): on_trial, active, paused, past_due, unpaid, cancelled or expired
- `test_mode` (true/false): True for a test-mode subscription
- `trial_ends_at` (text): When a trial ends (ISO 8601)
- `update_payment_url` (text): Where the customer updates their card (works for 24 hours)
- `variant_id` (text): The price's ID
- `variant_name` (text): The price, such as Monthly

**Example output**

```json
{
  "cancelled": false,
  "card_brand": "visa",
  "card_last_four": "4242",
  "created_at": "2026-10-27T10:00:00.000000Z",
  "customer_email": "sam@example.com",
  "customer_id": "201",
  "customer_name": "Sam Lee",
  "customer_portal_url": "https://example.lemonsqueezy.com/billing?expires=1",
  "ends_at": "",
  "id": "301",
  "order_id": "1001",
  "pause_mode": "void",
  "paused": true,
  "product_id": "10",
  "product_name": "Pro plan",
  "renews_at": "2027-10-27T10:00:00.000000Z",
  "resumes_at": "",
  "status": "paused",
  "test_mode": false,
  "trial_ends_at": "",
  "update_payment_url": "https://example.lemonsqueezy.com/subscription/301/payment-details",
  "variant_id": "11",
  "variant_name": "Yearly"
}
```

### Refund order

Refund an order in full, or part of it. It cannot be undone.

**Inputs**

- Order (`order`, text, required): The order's ID, from 'List orders' or the 'New order' trigger.
- Amount (`amount`, number): How much to refund, in the store's currency. Leave empty to refund it all. At least 0.01.

**Outputs**

- `created_at` (text): When it was placed (ISO 8601)
- `currency` (text): The currency, such as USD
- `customer_email` (text): The buyer's email address
- `customer_id` (text): The buyer's customer ID
- `customer_name` (text): The buyer's name
- `id` (text): The order's ID
- `order_number` (number): Its number in the store
- `product_id` (text): The product's ID
- `product_name` (text): The product bought
- `receipt_url` (text): The buyer's receipt
- `refunded` (true/false): True when refunded
- `refunded_amount` (number): How much was refunded
- `status` (text): pending, failed, paid, refunded, partial_refund or fraudulent
- `test_mode` (true/false): True for a test-mode order
- `total` (number): What they paid, in the store's currency
- `total_formatted` (text): What they paid, as shown, such as $11.99
- `variant_id` (text): The price's ID
- `variant_name` (text): The price bought

**Example output**

```json
{
  "created_at": "2026-10-27T10:00:00.000000Z",
  "currency": "USD",
  "customer_email": "sam@example.com",
  "customer_id": "201",
  "customer_name": "Sam Lee",
  "id": "1001",
  "order_number": 42,
  "product_id": "10",
  "product_name": "Pro plan",
  "receipt_url": "https://app.lemonsqueezy.com/my-orders/abc/receipt",
  "refunded": true,
  "refunded_amount": 99.0,
  "status": "refunded",
  "test_mode": false,
  "total": 99.0,
  "total_formatted": "$99.00",
  "variant_id": "11",
  "variant_name": "Yearly"
}
```

### Resume subscription

Start charging a paused subscription again, or keep a cancelled one from ending.

**Inputs**

- Subscription (`subscription`, text, required): The subscription's ID, from 'List subscriptions' or the 'New subscription' trigger.

**Outputs**

- `cancelled` (true/false): True when it ends at the period's end
- `card_brand` (text): The card's brand, such as visa
- `card_last_four` (text): The card's last four digits
- `created_at` (text): When it started (ISO 8601)
- `customer_email` (text): The customer's email address
- `customer_id` (text): The customer's ID
- `customer_name` (text): The customer's name
- `customer_portal_url` (text): Where the customer manages it (works for 24 hours)
- `ends_at` (text): When a cancelled one ends (ISO 8601)
- `id` (text): The subscription's ID
- `order_id` (text): The order that started it
- `pause_mode` (text): void (keep access, no charge) or free; empty if not paused
- `paused` (true/false): True when payments are paused
- `product_id` (text): The product's ID
- `product_name` (text): The product
- `renews_at` (text): When it next renews (ISO 8601)
- `resumes_at` (text): When a pause ends (ISO 8601); empty if not set
- `status` (text): on_trial, active, paused, past_due, unpaid, cancelled or expired
- `test_mode` (true/false): True for a test-mode subscription
- `trial_ends_at` (text): When a trial ends (ISO 8601)
- `update_payment_url` (text): Where the customer updates their card (works for 24 hours)
- `variant_id` (text): The price's ID
- `variant_name` (text): The price, such as Monthly

**Example output**

```json
{
  "cancelled": false,
  "card_brand": "visa",
  "card_last_four": "4242",
  "created_at": "2026-10-27T10:00:00.000000Z",
  "customer_email": "sam@example.com",
  "customer_id": "201",
  "customer_name": "Sam Lee",
  "customer_portal_url": "https://example.lemonsqueezy.com/billing?expires=1",
  "ends_at": "",
  "id": "301",
  "order_id": "1001",
  "pause_mode": "",
  "paused": false,
  "product_id": "10",
  "product_name": "Pro plan",
  "renews_at": "2027-10-27T10:00:00.000000Z",
  "resumes_at": "",
  "status": "active",
  "test_mode": false,
  "trial_ends_at": "",
  "update_payment_url": "https://example.lemonsqueezy.com/subscription/301/payment-details",
  "variant_id": "11",
  "variant_name": "Yearly"
}
```

### Update license key

Turn a license key off or on, or change how many devices or how long it works.

**Inputs**

- License key (`license_key`, text, required): The license key's ID, from 'Find license keys'.
- Turned off (`disabled`, true/false): On to stop the key working, off to let it work again.
- Devices allowed (`activation_limit`, number): How many devices it may be used on. Leave empty to keep it. At least 1.
- Expires (`expires_at`, date and time): When it stops working. Leave empty to keep it.

**Outputs**

- `activation_limit` (number): How many devices it may be used on; empty for no limit
- `activations` (number): How many devices it is used on
- `created_at` (text): When it was made (ISO 8601)
- `customer_email` (text): The buyer's email address
- `expires_at` (text): When it expires (ISO 8601); empty if never
- `id` (text): The license key's ID
- `key` (text): The full key
- `key_short` (text): Its last characters, such as XXXX-8A9B1C2D3E4F
- `order_id` (text): The order it came with
- `product_id` (text): The product it is for
- `status` (text): inactive, active, expired or disabled

**Example output**

```json
{
  "activation_limit": 3,
  "activations": 1,
  "created_at": "2026-10-27T10:00:00.000000Z",
  "customer_email": "sam@example.com",
  "expires_at": "",
  "id": "501",
  "key": "38b1460a-5104-4067-a91d-77b872934d51",
  "key_short": "XXXX-77b872934d51",
  "order_id": "1001",
  "product_id": "10",
  "status": "active"
}
```
