> 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="https://301624521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyKHM836KGDAfAWvw6XL6%2Fuploads%2F8p1DrODoyrgtdsQSzErr%2FScreenshot%202024-09-17%20at%2011.17.32%20PM.png?alt=media&amp;token=883f9a30-604f-4cff-b2f9-56e9b20eda27" 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="https://301624521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyKHM836KGDAfAWvw6XL6%2Fuploads%2FR1vEzUmD17jWTQxpuwfB%2FScreenshot%202025-04-26%20at%2012.09.41%20PM.png?alt=media&amp;token=2d07f91a-a456-4f38-bd78-c52440ebf832" 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="https://301624521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyKHM836KGDAfAWvw6XL6%2Fuploads%2Fku3El8NRiHWMpYCRW6Rx%2FScreenshot%202026-05-14%20at%207.18.13%E2%80%AFPM.png?alt=media&amp;token=8b10ea9c-bb48-454b-b6a9-624fc17168f5" 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="https://301624521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyKHM836KGDAfAWvw6XL6%2Fuploads%2FHCrH710l2SfTfudgMota%2Fscreencapture-console-aissist-io-workspace-actions-2869482a-30eb-47c8-bb56-a5d5edb6dec8-2025-04-26-12_16_47.png?alt=media&amp;token=f69cb9d8-08c0-4edd-addb-4f7b92048624" 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).