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