> For the complete documentation index, see [llms.txt](https://doc.aissist.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.aissist.io/integrations/shopify.md).

# Shopify

*Last updated: May 15, 2026*

Connect Shopify to let Aissist read store data and run commerce actions.

Shopify is the integration.

Actions use Shopify during conversations.

With Shopify, Aissist can work with:

* customers and orders
* shipping, fulfillment, and returns
* inventory and products
* actions like address updates and order cancellation

### Before you start

You currently need a Shopify access token to complete setup.

{% hint style="warning" %}
Login-based Shopify connection is not available yet. Use an access token instead.
{% endhint %}

{% hint style="info" %}
On the Shopify Basic plan, Shopify restricts access to some personal customer data, such as name, address, phone number, and email.
{% endhint %}

<details>

<summary>Create the Shopify integration</summary>

#### Step 1: add the integration

1. Go to **Workspace → Integrations**.
2. Click **Add Integration**.
3. Choose **Shopify**.
4. Enter:
   * a name for the integration
   * the shop name
   * the shop URL
   * the access token

#### Step 2: create a Shopify access token

1. Log in to your **Shopify dashboard**.
2. Navigate to **Settings** → **Apps and Sales Channels** → **Develop Apps**.
3. Enable **Custom App Development**.
4. Click **Create an app** and give it a name.
5. Open the app, go to **API Credentials**, then click **Configure Admin API Scopes**.
6. Grant these permissions:
   * `read_shipping`
   * `read_fulfillments`
   * `read_merchant_managed_fulfillments`
   * `read_customers`
   * `read_inventory`
   * `read_orders`
   * `read_returns`
   * `read_products`
   * `read_product_listings`
   * `write_orders`
7. Click **Install App**.
8. Copy the **Admin API Access Token**.

[See Shopify’s guide](https://shopify.dev/docs/apps/auth/admin-app-access-tokens) for more detail.

<figure><img src="/files/QPHbE98orwlGY6tJwEOW" alt=""><figcaption></figcaption></figure>

#### Step 3: finish setup in Aissist

1. Return to Aissist.
2. Paste the access token into the Shopify integration.
3. Click **Test** to confirm the token and URL work.

Example:

* Name: Aissist Shopify
* Shop: aissistant
* Shop URL: `https://aissistant.myshopify.com`
* Access Token: paste the token you created

<figure><img src="/files/VrkYPXZQBvyT7gChnO8y" alt=""><figcaption><p>Shopify integration builder</p></figcaption></figure>

</details>

<details>

<summary>Default actions</summary>

The Shopify integration includes default actions for common workflows.

Use them when the built-in Shopify methods already match your workflow.

You can choose whether each action runs:

* at the start of a session
* during an interaction
* in both places

Each default action includes predefined descriptions and parameters.

Create custom actions only when you need store-specific logic.

<figure><img src="/files/eCLPCbkwKh6zDMiRhT0i" alt=""><figcaption><p>Actions of Shopify integration</p></figcaption></figure>

</details>

<details>

<summary>Custom actions</summary>

You can also create custom Shopify actions.

If you do, turn off overlapping default actions to avoid conflicts.

#### Create a custom action

1. Select the integration then go to **Actions**.
2. Click **Add Action**.
3. Choose a method.
4. Give the action a clear name and description.

Available methods include:

`getOrder`, `getCustomer`, `getCustomerOrders`, `sendOrderInvoice`, `cancelOrder`, `updateOrderAddress`, `addOrderTags` , `unsubscribeMarketingEmail` , `getProducts`, and `getProductById`

#### Configure the action

You can:

* choose whether it runs inbound or outbound
* define trigger scenario
* customize parameters for your store logic

Use parameter descriptions that match your store rules.

Example store-specific guidance:

> order\_id: order IDs start with an `E` followed by 8 digits
>
> warranty\_days: warranty period in days, use constant `730`
>
> match\_email: only return the order if the email matches, use constant `true`
>
> order\_in\_last\_n\_days: retrieve orders from the last `180` days

You can also add instructions for how Aissist should summarize large action responses.

<figure><img src="/files/QYYar2YITx9JvSSpjsmM" alt=""><figcaption><p>Example getCustomer action</p></figcaption></figure>

</details>

### Next step

After setup, test your Shopify actions in [Action Debugger](/integrations/action-debugger.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.aissist.io/integrations/shopify.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.