> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Loyverse

The Loyverse connector lets your AI agent act in each user's Loyverse account. Each user connects their own Loyverse access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 56 tools.

**Authentication:** Bearer Token
**Categories:** Accounting & Finance, CRM & Sales
**Tools:** 56: 32 read, 13 write, 11 destructive
**Users sign in with:** Access token
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=LOYVERSE)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Loyverse connection

   In **AgentKit > Connections**, create a Loyverse connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'loyverse'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Loyverse:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'loyverse_categories_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "loyverse"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Loyverse:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="loyverse_categories_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Loyverse credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'loyverse_categories_list',
  toolInput: {},
  connector: 'loyverse',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="loyverse_categories_list",
    tool_input={},
    connection_name="loyverse",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `loyverse_categories_list`

List Categories · Read-only

List item categories. Returns per category its id, name and color. Results are paged: pass the returned cursor to get the next page.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `categories_ids` (`string`, optional): Comma-separated category IDs to return. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.
- `cursor` (`string`, optional): Cursor from the previous response's cursor field, to get the next page. Example: eyJsYXN0SWQiOiIxMjM0In0=.
- `limit` (`integer`, optional): Maximum number of results to return, 1 to 250. Defaults to 50. Example: 50.
- `show_deleted` (`boolean`, optional): Include deleted records. Defaults to false. Example: false.

Example input: `{}`

### `loyverse_category_get`

Get Category · Read-only

Get one category by ID. Returns its name and color.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `category_id` (`string`, required): ID of the category. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{"category_id":"<category_id>"}`

### `loyverse_customer_get`

Get Customer · Read-only

Get one customer by ID. Returns contact details, note, points balance, first and last visit, visits and total spent.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `customer_id` (`string`, required): ID of the customer. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{"customer_id":"<customer_id>"}`

### `loyverse_customers_list`

List Customers · Read-only

List customers, optionally by email or date range. Returns per customer their id, name, email, phone, address, customer code, note, points balance, visits and total spent. Results are paged: pass the returned cursor to get the next page.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `created_at_max` (`string`, optional): Only records created at or before this time (ISO 8601). Example: 2026-12-31T23:59:59.000Z.
- `created_at_min` (`string`, optional): Only records created at or after this time (ISO 8601). Example: 2026-01-01T00:00:00.000Z.
- `cursor` (`string`, optional): Cursor from the previous response's cursor field, to get the next page. Example: eyJsYXN0SWQiOiIxMjM0In0=.
- `customer_ids` (`string`, optional): Comma-separated customer IDs. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.
- `email` (`string`, optional): Exact customer email. Example: jane@example.com.
- `limit` (`integer`, optional): Maximum number of results to return, 1 to 250. Defaults to 50. Example: 50.
- `updated_at_max` (`string`, optional): Only records updated at or before this time (ISO 8601). Example: 2026-12-31T23:59:59.000Z.
- `updated_at_min` (`string`, optional): Only records updated at or after this time (ISO 8601). Example: 2026-01-01T00:00:00.000Z.

Example input: `{}`

### `loyverse_discount_get`

Get Discount · Read-only

Get one discount by ID. Returns its name, type, value, stores and restricted access flag.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `discount_id` (`string`, required): ID of the discount. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{"discount_id":"<discount_id>"}`

### `loyverse_discounts_list`

List Discounts · Read-only

List discounts. Returns per discount its id, name, type, amount or percent, stores and restricted access flag.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `created_at_max` (`string`, optional): Only records created at or before this time (ISO 8601). Example: 2026-12-31T23:59:59.000Z.
- `created_at_min` (`string`, optional): Only records created at or after this time (ISO 8601). Example: 2026-01-01T00:00:00.000Z.
- `discount_ids` (`string`, optional): Comma-separated discount IDs to return. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.
- `show_deleted` (`boolean`, optional): Include deleted records. Defaults to false. Example: false.
- `updated_at_max` (`string`, optional): Only records updated at or before this time (ISO 8601). Example: 2026-12-31T23:59:59.000Z.
- `updated_at_min` (`string`, optional): Only records updated at or after this time (ISO 8601). Example: 2026-01-01T00:00:00.000Z.

Example input: `{}`

### `loyverse_employee_get`

Get Employee · Read-only

Get one employee by ID. Returns name, email, phone, role and stores.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `employee_id` (`string`, required): ID of the employee. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{"employee_id":"<employee_id>"}`

### `loyverse_employees_list`

List Employees · Read-only

List employees. Returns per employee their id, name, email, phone, role and stores. Results are paged: pass the returned cursor to get the next page.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `created_at_max` (`string`, optional): Only records created at or before this time (ISO 8601). Example: 2026-12-31T23:59:59.000Z.
- `created_at_min` (`string`, optional): Only records created at or after this time (ISO 8601). Example: 2026-01-01T00:00:00.000Z.
- `cursor` (`string`, optional): Cursor from the previous response's cursor field, to get the next page. Example: eyJsYXN0SWQiOiIxMjM0In0=.
- `employee_ids` (`string`, optional): Comma-separated employee IDs to return. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.
- `limit` (`integer`, optional): Maximum number of results to return, 1 to 250. Defaults to 50. Example: 50.
- `show_deleted` (`boolean`, optional): Include deleted records. Defaults to false. Example: false.
- `updated_at_max` (`string`, optional): Only records updated at or before this time (ISO 8601). Example: 2026-12-31T23:59:59.000Z.
- `updated_at_min` (`string`, optional): Only records updated at or after this time (ISO 8601). Example: 2026-01-01T00:00:00.000Z.

Example input: `{}`

### `loyverse_inventory_list`

List Inventory Levels · Read-only

List stock levels per item variant and store, optionally of some stores or variants. Returns per entry variant_id, store_id, in_stock and updated_at. Results are paged: pass the returned cursor to get the next page.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Cursor from the previous response's cursor field, to get the next page. Example: eyJsYXN0SWQiOiIxMjM0In0=.
- `limit` (`integer`, optional): Maximum number of results to return, 1 to 250. Defaults to 50. Example: 50.
- `store_ids` (`string`, optional): Comma-separated store IDs. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.
- `updated_at_max` (`string`, optional): Only records updated at or before this time (ISO 8601). Example: 2026-12-31T23:59:59.000Z.
- `updated_at_min` (`string`, optional): Only records updated at or after this time (ISO 8601). Example: 2026-01-01T00:00:00.000Z.
- `variant_ids` (`string`, optional): Comma-separated variant IDs. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{}`

### `loyverse_item_get`

Get Item · Read-only

Get one item by ID with its variants, prices, category, taxes, modifiers and components.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `item_id` (`string`, required): ID of the item. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{"item_id":"<item_id>"}`

### `loyverse_items_list`

List Items · Read-only

List items (products) with their variants. Returns per item its id, name, description, category, taxes, modifiers, options and variants with SKU, barcode, prices per store and costs. Results are paged: pass the returned cursor to get the next page. Use loyverse_variants_list to look up by SKU.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `created_at_max` (`string`, optional): Only records created at or before this time (ISO 8601). Example: 2026-12-31T23:59:59.000Z.
- `created_at_min` (`string`, optional): Only records created at or after this time (ISO 8601). Example: 2026-01-01T00:00:00.000Z.
- `cursor` (`string`, optional): Cursor from the previous response's cursor field, to get the next page. Example: eyJsYXN0SWQiOiIxMjM0In0=.
- `items_ids` (`string`, optional): Comma-separated item IDs to return. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.
- `limit` (`integer`, optional): Maximum number of results to return, 1 to 250. Defaults to 50. Example: 50.
- `show_deleted` (`boolean`, optional): Include deleted records. Defaults to false. Example: false.
- `updated_at_max` (`string`, optional): Only records updated at or before this time (ISO 8601). Example: 2026-12-31T23:59:59.000Z.
- `updated_at_min` (`string`, optional): Only records updated at or after this time (ISO 8601). Example: 2026-01-01T00:00:00.000Z.

Example input: `{}`

### `loyverse_merchant_get`

Get Merchant · Read-only

Get the merchant account: business name, email, country, currency and creation date. Use this to check the connection.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `loyverse_modifier_get`

Get Modifier · Read-only

Get one modifier by ID with its options, prices and stores.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `modifier_id` (`string`, required): ID of the modifier. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{"modifier_id":"<modifier_id>"}`

### `loyverse_modifiers_list`

List Modifiers · Read-only

List modifiers (option groups such as extra toppings) with their options and prices. Results are paged: pass the returned cursor to get the next page.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `created_at_max` (`string`, optional): Only records created at or before this time (ISO 8601). Example: 2026-12-31T23:59:59.000Z.
- `created_at_min` (`string`, optional): Only records created at or after this time (ISO 8601). Example: 2026-01-01T00:00:00.000Z.
- `cursor` (`string`, optional): Cursor from the previous response's cursor field, to get the next page. Example: eyJsYXN0SWQiOiIxMjM0In0=.
- `limit` (`integer`, optional): Maximum number of results to return, 1 to 250. Defaults to 50. Example: 50.
- `modifier_ids` (`string`, optional): Comma-separated modifier IDs to return. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.
- `show_deleted` (`boolean`, optional): Include deleted records. Defaults to false. Example: false.
- `updated_at_max` (`string`, optional): Only records updated at or before this time (ISO 8601). Example: 2026-12-31T23:59:59.000Z.
- `updated_at_min` (`string`, optional): Only records updated at or after this time (ISO 8601). Example: 2026-01-01T00:00:00.000Z.

Example input: `{}`

### `loyverse_payment_type_get`

Get Payment Type · Read-only

Get one payment type by ID. Returns its name and type.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `payment_type_id` (`string`, required): ID of the payment type. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{"payment_type_id":"<payment_type_id>"}`

### `loyverse_payment_types_list`

List Payment Types · Read-only

List payment types (cash, card and custom ones). Returns per type its id, name and type. Use this to find a payment_type_id for receipts.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `created_at_max` (`string`, optional): Only records created at or before this time (ISO 8601). Example: 2026-12-31T23:59:59.000Z.
- `created_at_min` (`string`, optional): Only records created at or after this time (ISO 8601). Example: 2026-01-01T00:00:00.000Z.
- `payment_type_ids` (`string`, optional): Comma-separated payment type IDs to return. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.
- `show_deleted` (`boolean`, optional): Include deleted records. Defaults to false. Example: false.
- `updated_at_max` (`string`, optional): Only records updated at or before this time (ISO 8601). Example: 2026-12-31T23:59:59.000Z.
- `updated_at_min` (`string`, optional): Only records updated at or after this time (ISO 8601). Example: 2026-01-01T00:00:00.000Z.

Example input: `{}`

### `loyverse_pos_device_get`

Get POS Device · Read-only

Get one POS device by ID. Returns its name, store and activation state.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `pos_device_id` (`string`, required): ID of the pos device. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{"pos_device_id":"<pos_device_id>"}`

### `loyverse_pos_devices_list`

List POS Devices · Read-only

List POS devices, optionally of one store. Returns per device its id, name, store and activation state.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `show_deleted` (`boolean`, optional): Include deleted records. Defaults to false. Example: false.
- `store_id` (`string`, optional): Only devices of this store ID. Example: c1a2b3c4-1111-4a5b-9c8d-0123456789ab.

Example input: `{}`

### `loyverse_receipt_get`

Get Receipt · Read-only

Get one receipt by number. Returns its type, dates, store, employee, customer, totals, taxes, discounts, line items and payments.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `receipt_number` (`string`, required): Number of the sales receipt, e.g. 1-1001. Example: 1-1001.

Example input: `{"receipt_number":"<receipt_number>"}`

### `loyverse_receipts_list`

List Receipts · Read-only

List sales and refund receipts, optionally by numbers, store, order, source or date range. Returns per receipt its number, type, dates, store, employee, customer, totals, taxes, discounts, line items and payments. Results are paged: pass the returned cursor to get the next page.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `before_receipt_number` (`string`, optional): Only receipts before this receipt number. Example: 1-1100.
- `created_at_max` (`string`, optional): Only records created at or before this time (ISO 8601). Example: 2026-12-31T23:59:59.000Z.
- `created_at_min` (`string`, optional): Only records created at or after this time (ISO 8601). Example: 2026-01-01T00:00:00.000Z.
- `cursor` (`string`, optional): Cursor from the previous response's cursor field, to get the next page. Example: eyJsYXN0SWQiOiIxMjM0In0=.
- `limit` (`integer`, optional): Maximum number of results to return, 1 to 250. Defaults to 50. Example: 50.
- `order` (`string`, optional): Only receipts with this order name or number. Example: Table 12.
- `receipt_numbers` (`string`, optional): Comma-separated receipt numbers. Example: 1-1001,1-1002.
- `since_receipt_number` (`string`, optional): Only receipts after this receipt number. Example: 1-1001.
- `source` (`string`, optional): Only receipts from this source, e.g. point of sale or an app name. Example: My App.
- `store_id` (`string`, optional): Only receipts of this store ID. Example: c1a2b3c4-1111-4a5b-9c8d-0123456789ab.
- `updated_at_max` (`string`, optional): Only records updated at or before this time (ISO 8601). Example: 2026-12-31T23:59:59.000Z.
- `updated_at_min` (`string`, optional): Only records updated at or after this time (ISO 8601). Example: 2026-01-01T00:00:00.000Z.

Example input: `{}`

### `loyverse_shift_get`

Get Shift · Read-only

Get one shift by ID. Returns its store, device, times, employees, cash movements, gross and net sales, taxes and payments.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `shift_id` (`string`, required): ID of the shift. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{"shift_id":"<shift_id>"}`

### `loyverse_shifts_list`

List Shifts · Read-only

List cash register shifts, optionally of some stores or in a date range. Returns per shift its id, store, POS device, opening and closing times and employees, cash amounts, taxes and payments. Results are paged: pass the returned cursor to get the next page.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `created_at_max` (`string`, optional): Only records created at or before this time (ISO 8601). Example: 2026-12-31T23:59:59.000Z.
- `created_at_min` (`string`, optional): Only records created at or after this time (ISO 8601). Example: 2026-01-01T00:00:00.000Z.
- `cursor` (`string`, optional): Cursor from the previous response's cursor field, to get the next page. Example: eyJsYXN0SWQiOiIxMjM0In0=.
- `limit` (`integer`, optional): Maximum number of results to return, 1 to 250. Defaults to 50. Example: 50.
- `store_ids` (`string`, optional): Comma-separated store IDs. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{}`

### `loyverse_store_get`

Get Store · Read-only

Get one store by ID. Returns its name, address, phone and description.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `store_id` (`string`, required): ID of the store. Example: c1a2b3c4-1111-4a5b-9c8d-0123456789ab.

Example input: `{"store_id":"<store_id>"}`

### `loyverse_stores_list`

List Stores · Read-only

List the merchant's stores. Returns per store its id, name, address, phone and description. Use this to find a store_id.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `created_at_max` (`string`, optional): Only records created at or before this time (ISO 8601). Example: 2026-12-31T23:59:59.000Z.
- `created_at_min` (`string`, optional): Only records created at or after this time (ISO 8601). Example: 2026-01-01T00:00:00.000Z.
- `show_deleted` (`boolean`, optional): Include deleted records. Defaults to false. Example: false.
- `store_ids` (`string`, optional): Comma-separated store IDs to return. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.
- `updated_at_max` (`string`, optional): Only records updated at or before this time (ISO 8601). Example: 2026-12-31T23:59:59.000Z.
- `updated_at_min` (`string`, optional): Only records updated at or after this time (ISO 8601). Example: 2026-01-01T00:00:00.000Z.

Example input: `{}`

### `loyverse_supplier_get`

Get Supplier · Read-only

Get one supplier by ID. Returns name, contact, email, phone, website, address and note.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `supplier_id` (`string`, required): ID of the supplier. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{"supplier_id":"<supplier_id>"}`

### `loyverse_suppliers_list`

List Suppliers · Read-only

List suppliers. Returns per supplier its id, name, contact, email, phone, website and address. Results are paged: pass the returned cursor to get the next page.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Cursor from the previous response's cursor field, to get the next page. Example: eyJsYXN0SWQiOiIxMjM0In0=.
- `limit` (`integer`, optional): Maximum number of results to return, 1 to 250. Defaults to 50. Example: 50.
- `show_deleted` (`boolean`, optional): Include deleted records. Defaults to false. Example: false.
- `suppliers_ids` (`string`, optional): Comma-separated supplier IDs to return. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{}`

### `loyverse_tax_get`

Get Tax · Read-only

Get one tax by ID. Returns its name, rate, type and stores.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `tax_id` (`string`, required): ID of the tax. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{"tax_id":"<tax_id>"}`

### `loyverse_taxes_list`

List Taxes · Read-only

List taxes. Returns per tax its id, name, rate, type (included or added) and stores.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `created_at_max` (`string`, optional): Only records created at or before this time (ISO 8601). Example: 2026-12-31T23:59:59.000Z.
- `created_at_min` (`string`, optional): Only records created at or after this time (ISO 8601). Example: 2026-01-01T00:00:00.000Z.
- `show_deleted` (`boolean`, optional): Include deleted records. Defaults to false. Example: false.
- `tax_ids` (`string`, optional): Comma-separated tax IDs to return. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.
- `updated_at_max` (`string`, optional): Only records updated at or before this time (ISO 8601). Example: 2026-12-31T23:59:59.000Z.
- `updated_at_min` (`string`, optional): Only records updated at or after this time (ISO 8601). Example: 2026-01-01T00:00:00.000Z.

Example input: `{}`

### `loyverse_variant_get`

Get Item Variant · Read-only

Get one item variant by ID. Returns its item, SKU, barcode, option values, cost and prices per store.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `variant_id` (`string`, required): ID of the variant. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{"variant_id":"<variant_id>"}`

### `loyverse_variants_list`

List Item Variants · Read-only

List item variants, optionally by item, SKU or IDs. Returns per variant its id, item, SKU, barcode, option values, cost and prices per store. Results are paged: pass the returned cursor to get the next page.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `created_at_max` (`string`, optional): Only records created at or before this time (ISO 8601). Example: 2026-12-31T23:59:59.000Z.
- `created_at_min` (`string`, optional): Only records created at or after this time (ISO 8601). Example: 2026-01-01T00:00:00.000Z.
- `cursor` (`string`, optional): Cursor from the previous response's cursor field, to get the next page. Example: eyJsYXN0SWQiOiIxMjM0In0=.
- `items_ids` (`string`, optional): Comma-separated item IDs. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.
- `limit` (`integer`, optional): Maximum number of results to return, 1 to 250. Defaults to 50. Example: 50.
- `show_deleted` (`boolean`, optional): Include deleted records. Defaults to false. Example: false.
- `sku` (`string`, optional): Exact variant SKU. Example: 10001.
- `updated_at_max` (`string`, optional): Only records updated at or before this time (ISO 8601). Example: 2026-12-31T23:59:59.000Z.
- `updated_at_min` (`string`, optional): Only records updated at or after this time (ISO 8601). Example: 2026-01-01T00:00:00.000Z.
- `variants_ids` (`string`, optional): Comma-separated variant IDs. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{}`

### `loyverse_webhook_get`

Get Webhook · Read-only

Get one webhook by ID. Returns its URL, event type and status.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `webhook_id` (`string`, required): ID of the webhook. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{"webhook_id":"<webhook_id>"}`

### `loyverse_webhooks_list`

List Webhooks · Read-only

List webhooks. Returns per webhook its id, URL, event type and status.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `loyverse_category_upsert`

Create or Update Category · Write

Create an item category, or update one. Pass id to update an existing record instead of creating one. Returns the category.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Category name. Example: Drinks.
- `color` (`string`, optional): Category color on the POS. One of: GREY, RED, PINK, ORANGE, GREEN, BLUE, PURPLE. Example: BLUE. One of: `GREY`, `RED`, `PINK`, `ORANGE`, `GREEN`, `BLUE`, `PURPLE`.
- `id` (`string`, optional): ID of the category to update; leave empty to create one. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{"name":"<name>"}`

### `loyverse_customer_upsert`

Create or Update Customer · Write

Create a customer, or update one. Pass id to update an existing record instead of creating one. Returns the customer.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): The customer's name. Example: Jane Doe.
- `address` (`string`, optional): The customer's address. Example: 123 Main St.
- `city` (`string`, optional): The customer's city, town, or village. Example: Austin.
- `country_code` (`string`, optional): The two-letter country code corresponding to the customer's country in ISO 3166-1-alpha-2 format. Example: US.
- `customer_code` (`string`, optional): Your own code for the customer, e.g. a loyalty card number. Example: C-1001.
- `email` (`string`, optional): The customer's email. Example: jane@example.com.
- `id` (`string`, optional): ID of the customer to update; leave empty to create one. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.
- `note` (`string`, optional): The note about the customer. Example: Prefers oat milk.
- `phone_number` (`string`, optional): The customer's phone number. Example: +15555550123.
- `postal_code` (`string`, optional): The customer’s postal code, also known as zip, postcode, Eircode, etc. Example: 78701.
- `region` (`string`, optional): The customer’s region name. Typically a province, a state, or a prefecture. Example: TX.
- `total_points` (`number`, optional): Actual customer points balance. Example: 120.

Example input: `{"name":"<name>"}`

### `loyverse_discount_upsert`

Create or Update Discount · Write

Create a discount, or update one. Pass id to update an existing record instead of creating one. Returns the discount.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): The discount name. Example: Happy hour.
- `type` (`string`, required): The type of the discount. One of: FIXED_PERCENT, FIXED_AMOUNT, VARIABLE_PERCENT, VARIABLE_AMOUNT, DISCOUNT_BY_POINTS. Example: FIXED_PERCENT. One of: `FIXED_PERCENT`, `FIXED_AMOUNT`, `VARIABLE_PERCENT`, `VARIABLE_AMOUNT`, `DISCOUNT_BY_POINTS`.
- `discount_amount` (`number`, optional): The discount value in money representation (only for discounts with type FIXED_AMOUNT). Example: 2.
- `discount_percent` (`number`, optional): This is discount value in percentage (only for discounts with type FIXED_PERCENT). Example: 15.
- `id` (`string`, optional): ID of the discount to update; leave empty to create one. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.
- `restricted_access` (`boolean`, optional): If true, the password verification is necessary in order to apply this discount on POS. Example: false.
- `stores` (`array`, optional): IDs of the stores where the discount is available; all stores by default. Example: ["3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"]

Example input: `{"name":"<name>","type":"FIXED_PERCENT"}`

### `loyverse_inventory_update`

Update Inventory Levels · Write

Set the stock level of item variants at stores, in one batch. Returns the updated levels.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `inventory_levels` (`array`, required): Stock levels to set, each with variant_id, store_id and stock_after (the new quantity in stock). Example: [{"variant_id": "3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d", "store_id": "3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d", "stock_after": 25}]

Example input: `{"inventory_levels":[{"variant_id":"3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d","store_id":"3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d","stock_after":25}]}`

### `loyverse_item_upsert`

Create or Update Item · Write

Create an item (product) with its variants, or update one. Pass id to update an existing record instead of creating one. Returns the item with its variants.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `item_name` (`string`, required): Item name. Example: Cappuccino.
- `category_id` (`string`, optional): The category id of the item. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.
- `color` (`string`, optional): One of the predefined colors for the item that is displayed on the POS. Example: GREY. One of: `GREY`, `RED`, `PINK`, `ORANGE`, `YELLOW`, `GREEN`, `BLUE`, `PURPLE`.
- `description` (`string`, optional): The item description. Example: Double shot with steamed milk.
- `form` (`string`, optional): The visual form of the item that is displayed on the POS. One of: SQUARE, CIRCLE, SUN, OCTAGON. Example: SQUARE. One of: `SQUARE`, `CIRCLE`, `SUN`, `OCTAGON`.
- `id` (`string`, optional): ID of the item to update; leave empty to create one. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.
- `modifiers_ids` (`array`, optional): IDs of the modifiers offered with the item. Example: ["3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"]
- `option1_name` (`string`, optional): Name of the first variant option, e.g. Size. Example: Size.
- `option2_name` (`string`, optional): Name of the second variant option, e.g. Color. Example: Milk.
- `option3_name` (`string`, optional): Name of the third variant option, e.g. Material. Example: Temperature.
- `primary_supplier_id` (`string`, optional): ID of the item's main supplier. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.
- `reference_id` (`string`, optional): External reference id for the item. Example: CAP-01.
- `sold_by_weight` (`boolean`, optional): If true, a fractional quantity for this item can be specified at the time of a sale (for example 1.5). Example: false.
- `tax_ids` (`array`, optional): IDs of the taxes applied to the item. Example: ["3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"]
- `track_stock` (`boolean`, optional): If true, the system tracks inventory for this item at all stores. Make sure you don't accidentally disable track stock. If you set track_stock to false then all inventory levels of this item are set to 0. Example: false.
- `variants` (`array`, optional): Variants of the item, each with optional sku, barcode, option values, cost, default_pricing_type (FIXED or VARIABLE), default_price and per-store stores entries. Example: [{"option1_value": "Large", "sku": "10001", "default_pricing_type": "FIXED", "default_price": 4.5}].

Example input: `{"item_name":"<item_name>"}`

### `loyverse_modifier_upsert`

Create or Update Modifier · Write

Create a modifier with its options, or update one. Pass id to update an existing record instead of creating one. Returns the modifier.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `modifier_options` (`array`, required): Options of the modifier, each with name, price and optional position. Example: [{"name": "Extra shot", "price": 0.5}].
- `name` (`string`, required): The modifier name. Example: Extra shots.
- `id` (`string`, optional): ID of the modifier to update; leave empty to create one. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.
- `position` (`integer`, optional): Determines the position of this modifier in the modifiers list. Example: 1.
- `stores` (`array`, optional): IDs of the stores where the modifier is available. Example: ["3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"]

Example input: `{"modifier_options":[{"name":"Extra shot","price":0.5}],"name":"<name>"}`

### `loyverse_pos_device_upsert`

Create or Update POS Device · Write

Create a POS device for a store, or rename one. Pass id to update an existing record instead of creating one. Returns the device.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Device name. Example: Front counter.
- `store_id` (`string`, required): ID of the store the device belongs to. Example: c1a2b3c4-1111-4a5b-9c8d-0123456789ab.
- `id` (`string`, optional): ID of the POS device to update; leave empty to create one. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{"name":"<name>","store_id":"<store_id>"}`

### `loyverse_receipt_create`

Create Sales Receipt · Write

Record a sale as a receipt, with line items and one payment, for example an order placed in another system. Returns the new receipt with its number. Stock is reduced for tracked items.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `line_items` (`array`, required): Items sold, each with variant_id and quantity, and optionally price, cost and line_note. Example: [{"variant_id": "3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d", "quantity": 2, "price": 4.5}]
- `store_id` (`string`, required): ID of the store of the sale. Example: c1a2b3c4-1111-4a5b-9c8d-0123456789ab.
- `customer_id` (`string`, optional): The customer id associated with the receipt. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.
- `employee_id` (`string`, optional): The employee id associated with the receipt. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.
- `note` (`string`, optional): The receipt's note. Example: Online order.
- `order` (`string`, optional): The order name or number associated with the receipt. Example: Table 12.
- `payments` (`array`, optional): The payment, as a one-element list with payment_type_id and money_amount (only one payment is allowed). Example: [{"payment_type_id": "3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d", "money_amount": 9}]
- `receipt_date` (`string`, optional): When the sale happened (ISO 8601); defaults to now. Example: 2026-03-15T10:30:00.000Z.
- `source` (`string`, optional): The name of the the source this receipt comes from. By default it is the name of the application that created the receipt. For receipts created from Loyverse mobile point of sale application the value is "point of sale". Example: My App.

Example input: `{"line_items":[{"variant_id":"3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d","quantity":2,"price":4.5}],"store_id":"<store_id>"}`

### `loyverse_receipt_refund`

Refund Receipt · Write

Create a refund receipt for some or all line items of a sales receipt. Returns the refund receipt.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `line_items` (`array`, required): Line items to refund, each with the id of the original receipt line and the quantity to refund. Example: [{"id": "3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d", "quantity": 1}]
- `receipt_number` (`string`, required): Number of the sales receipt, e.g. 1-1001. Example: 1-1001.
- `employee_id` (`string`, optional): The employee id associated with the receipt. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.
- `receipt_date` (`string`, optional): By default, it matches the created_at value (time when receipt was created on the Loyverse server). You can set receipt_date to the value that is equal to the date and time in the past when the refund was created in another system. Example: 2026-03-16T09:00:00.000Z.
- `source` (`string`, optional): The name of the the source this receipt comes from. By default it is the name of the application that created the receipt. Example: My App.
- `store_id` (`string`, optional): Store of the refund; defaults to the store of the sale. Example: c1a2b3c4-1111-4a5b-9c8d-0123456789ab.

Example input: `{"line_items":[{"id":"3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d","quantity":1}],"receipt_number":"<receipt_number>"}`

### `loyverse_supplier_upsert`

Create or Update Supplier · Write

Create a supplier, or update one. Pass id to update an existing record instead of creating one. Returns the supplier.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): The supplier company name. Example: Bean Co.
- `address_1` (`string`, optional): The supplier address. Example: 1 Roast St.
- `address_2` (`string`, optional): The supplier address. Example: Unit 2.
- `city` (`string`, optional): The supplier city, town, or village. Example: Portland.
- `contact` (`string`, optional): The supplier contact person name. Example: Sam Lee.
- `country_code` (`string`, optional): The two-letter country code corresponding to the supplier country in ISO 3166-1-alpha-2 format. Example: US.
- `email` (`string`, optional): The supplier email. Example: orders@beanco.example.
- `id` (`string`, optional): ID of the supplier to update; leave empty to create one. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.
- `note` (`string`, optional): Note about the supplier. Example: Delivers Tuesdays.
- `phone_number` (`string`, optional): Supplier phone number. Example: +15555550123.
- `postal_code` (`string`, optional): The supplier’s postal code, also known as zip, postcode, Eircode, etc. Example: 97201.
- `region` (`string`, optional): The supplier’s region name. Typically a province, a state, or a prefecture. Example: OR.
- `website` (`string`, optional): The supplier website page. Example: https://beanco.example.

Example input: `{"name":"<name>"}`

### `loyverse_tax_upsert`

Create or Update Tax · Write

Create a tax, or update one. Pass id to update an existing record instead of creating one. Returns the tax.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): The tax name. Example: VAT.
- `rate` (`number`, required): The tax rate. For example, a value of "5.255" corresponds to a percentage of 5.255%. Example: 20.
- `type` (`string`, required): If the type is INCLUDED then the tax is included in an item price. If the type is ADDED then the tax is added to an item price. One of: INCLUDED, ADDED. Example: ADDED. One of: `INCLUDED`, `ADDED`.
- `id` (`string`, optional): ID of the tax to update; leave empty to create one. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.
- `stores` (`array`, optional): IDs of the stores where the tax applies. Example: ["3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d"]

Example input: `{"name":"<name>","rate":20,"type":"INCLUDED"}`

### `loyverse_variant_upsert`

Create or Update Item Variant · Write

Add a variant to an existing item, or update a variant (pass variant_id). Returns the variant.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `barcode` (`string`, optional): Barcode. Example: 4006381333931.
- `cost` (`number`, optional): The variant cost. Example: 1.2.
- `default_price` (`number`, optional): The default variant price (only for pricing_type: FIXED) If there are several stores in the account than the price of the variant in each store is equal to this value by default unless different value is specified in the stores array for a particular store. Example: 4.5.
- `default_pricing_type` (`string`, optional): The default variant pricing type. If the value is VARIABLE than the price is specified at the time of a sale. If there are several stores in the account than the price of the variant in each store is equal to this value by default unless different value is specified in the stores array for a particular store. One of: FIXED, VARIABLE. Example: FIXED. One of: `FIXED`, `VARIABLE`.
- `item_id` (`string`, optional): ID of the item the variant belongs to (required when creating). Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.
- `option1_value` (`string`, optional): The value of the first option for this variant. Required if option1_name is set for the item this variant is attached to. Example: Large.
- `option2_value` (`string`, optional): The value of the second option for this variant. Required if option2_name is set for the item this variant is attached to. Example: Oat.
- `option3_value` (`string`, optional): The value of the third option for this variant. Required if option3_name is set for the item this variant is attached to. Example: Hot.
- `purchase_cost` (`number`, optional): The variant purchase cost. Example: 1.1.
- `reference_variant_id` (`string`, optional): External reference id for the variant. Example: CAP-01-L.
- `sku` (`string`, optional): The variant sku. It should be unique. Example: 10001.
- `stores` (`array`, optional): Per-store settings, each with store_id, pricing_type, price, available_for_sale, optimal_stock and low_stock. Example: [{"store_id": "3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d", "pricing_type": "FIXED", "price": 4.5, "available_for_sale": true}]
- `variant_id` (`string`, optional): ID of the variant to update; leave empty to create one. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{}`

### `loyverse_webhook_upsert`

Create or Update Webhook · Write

Create a webhook that posts one event type (inventory, items, customers, receipts or shifts) to a URL, or update one by id. Returns the webhook.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `type` (`string`, required): Event to send. One of: inventory_levels.update, items.update, customers.update, receipts.update, shifts.create. Example: receipts.update. One of: `inventory_levels.update`, `items.update`, `customers.update`, `receipts.update`, `shifts.create`.
- `url` (`string`, required): HTTPS URL that receives the events. Example: https://example.com/loyverse-webhook.
- `id` (`string`, optional): ID of the webhook to update; leave empty to create one. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.
- `status` (`string`, optional): ENABLED or DISABLED. One of: ENABLED, DISABLED. Example: ENABLED. One of: `ENABLED`, `DISABLED`.

Example input: `{"type":"inventory_levels.update","url":"<url>"}`

### `loyverse_category_delete`

Delete Category · Destructive

Delete a category; its items stay uncategorized.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `category_id` (`string`, required): ID of the category. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{"category_id":"<category_id>"}`

### `loyverse_customer_delete`

Delete Customer · Destructive

Delete a customer.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `customer_id` (`string`, required): ID of the customer. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{"customer_id":"<customer_id>"}`

### `loyverse_discount_delete`

Delete Discount · Destructive

Delete a discount.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `discount_id` (`string`, required): ID of the discount. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{"discount_id":"<discount_id>"}`

### `loyverse_item_delete`

Delete Item · Destructive

Delete an item and its variants.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `item_id` (`string`, required): ID of the item. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{"item_id":"<item_id>"}`

### `loyverse_item_image_delete`

Delete Item Image · Destructive

Remove the image of an item.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `item_id` (`string`, required): ID of the item. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{"item_id":"<item_id>"}`

### `loyverse_modifier_delete`

Delete Modifier · Destructive

Delete a modifier.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `modifier_id` (`string`, required): ID of the modifier. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{"modifier_id":"<modifier_id>"}`

### `loyverse_pos_device_delete`

Delete POS Device · Destructive

Delete a POS device.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `pos_device_id` (`string`, required): ID of the pos device. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{"pos_device_id":"<pos_device_id>"}`

### `loyverse_supplier_delete`

Delete Supplier · Destructive

Delete a supplier.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `supplier_id` (`string`, required): ID of the supplier. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{"supplier_id":"<supplier_id>"}`

### `loyverse_tax_delete`

Delete Tax · Destructive

Delete a tax.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `tax_id` (`string`, required): ID of the tax. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{"tax_id":"<tax_id>"}`

### `loyverse_variant_delete`

Delete Item Variant · Destructive

Delete an item variant.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `variant_id` (`string`, required): ID of the variant. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{"variant_id":"<variant_id>"}`

### `loyverse_webhook_delete`

Delete Webhook · Destructive

Delete a webhook.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `webhook_id` (`string`, required): ID of the webhook. Example: 3f1b2c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d.

Example input: `{"webhook_id":"<webhook_id>"}`

## Related

Other Accounting & Finance connectors ([all 82](/agentkit/connectors/?category=accounting-finance)):

- [QuickBooks](/agentkit/connectors/quickbooks/): Scalekit connector, OAuth, 117 tools
- [Xero](/agentkit/connectors/xero/): Scalekit connector, OAuth, 94 tools
- [Stripe](/agentkit/connectors/stripe/): Scalekit connector, Access token, 178 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
