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

# Shopify

> Connect Shopify to your Atako agents — 15 read and 17 write actions.

Let your agents run your Shopify store — manage orders, products, customers, inventory, fulfillments and discounts.

## Connection

* **Authentication**: API key (Admin API access token (shpat\_...)).
* **Required settings**:
  * **Store name** — yourstore in yourstore.myshopify.com

<Note>
  Shopify admin → Settings → Apps and sales channels → Develop apps → Create an app → Configure Admin API scopes (enable read\_orders, write\_orders, read\_products, write\_products, read\_customers, write\_customers, read\_inventory, write\_inventory, read\_fulfillments, write\_fulfillments, read\_locations, read\_discounts, write\_discounts) → Install app → API credentials → Reveal token once and copy it (starts with shpat\_).

  See [Shopify's documentation](https://shopify.dev/docs/apps/build/authentication-authorization/access-tokens/generate-app-access-tokens-admin).
</Note>

## Read actions (15)

| Action                    | Description                                                                                      |
| ------------------------- | ------------------------------------------------------------------------------------------------ |
| `count_products`          | Count products, filterable by vendor, type or status.                                            |
| `get_customer`            | Fetch a single customer by id.                                                                   |
| `get_order`               | Fetch a single order by id.                                                                      |
| `get_product`             | Fetch a single product by id, including its variants and images.                                 |
| `list_customers`          | List customers, filterable by ids or creation/update date range.                                 |
| `list_discount_codes`     | List the discount codes attached to a price rule.                                                |
| `list_draft_orders`       | List draft orders, filterable by status.                                                         |
| `list_fulfillment_orders` | List the fulfillment orders of an order (needed before creating a fulfillment).                  |
| `list_inventory_levels`   | List inventory levels for given inventory items and/or locations (at least one filter required). |
| `list_locations`          | List the store locations that stock inventory.                                                   |
| `list_orders`             | List orders, filterable by status, payment and fulfillment state, or date range.                 |
| `list_price_rules`        | List price rules (the discount definitions that codes attach to).                                |
| `list_products`           | List products, filterable by title, vendor, type, status or collection.                          |
| `list_webhooks`           | List the webhook subscriptions registered on the store.                                          |
| `search_customers`        | Search customers with a filtered query (e.g. email:[bob@example.com](mailto:bob@example.com)).   |

## Write actions (17)

| Action                   | Description                                                                            |
| ------------------------ | -------------------------------------------------------------------------------------- |
| `adjust_inventory_level` | Adjust the available quantity of an inventory item at a location by a relative amount. |
| `cancel_order`           | Cancel an order, optionally refunding an amount and notifying the customer.            |
| `close_order`            | Close (archive) a fully paid and fulfilled order.                                      |
| `complete_draft_order`   | Complete a draft order, turning it into a real order.                                  |
| `create_customer`        | Create a customer record.                                                              |
| `create_discount_code`   | Create a discount code under an existing price rule.                                   |
| `create_draft_order`     | Create a draft order with line items, optionally attached to a customer.               |
| `create_fulfillment`     | Create a fulfillment for one or more fulfillment orders, with optional tracking info.  |
| `create_price_rule`      | Create a price rule (basic discount definition) to attach discount codes to.           |
| `create_product`         | Create a product with optional variants, options and images.                           |
| `create_webhook`         | Subscribe a callback URL to a store event topic (e.g. orders/create).                  |
| `delete_product`         | Permanently delete a product and all its variants.                                     |
| `delete_webhook`         | Delete a webhook subscription.                                                         |
| `set_inventory_level`    | Set the available quantity of an inventory item at a location to an absolute value.    |
| `update_customer`        | Update a customer (name, contact details, note, tags).                                 |
| `update_order`           | Update an order (note, tags, contact email or phone).                                  |
| `update_product`         | Update a product (title, description, status, tags, variants…).                        |

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