# Shopify  — Pipedream Connect

> Shopify is a complete commerce platform that lets anyone start, manage, and grow a business. You can use Shopify to build an online store, manage sales, market to customers, and accept payments in digital and physical locations.

- API slug: `shopify` (use in MCP headers and tool keys)
- Auth: OAuth (Pipedream-managed)
- Categories: Commerce
- Website: https://shopify.com/
- Managed OAuth scopes: `read_content` · `write_content` · `read_customers` · `write_customers` · `read_draft_orders` · `read_inventory` · `write_inventory` · `read_metaobjects` · `write_metaobjects` · `read_orders` · `write_orders` · `read_products` · `write_products` · `read_assigned_fulfillment_orders` · `read_merchant_managed_fulfillment_orders` · `write_merchant_managed_fulfillment_orders` · `read_third_party_fulfillment_orders`
- This page (HTML): https://pipedream.com/apps/shopify
- Tools: 57 actions · 8 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: shopify`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "shopify",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Add Products to Custom Collection:
const result = await mcp.callTool({
  name: "shopify-add-product-to-custom-collection",
  arguments: {
    productIds: ["Product IDs"],
    collectionId: "Collection ID",
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a Shopify  endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://api.example.com/v1/me

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkuZXhhbXBsZS5jb20vdjEvbWU?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "shopify-add-product-to-custom-collection",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    shopify: { authProvisionId: "apn_xxxxxxx" },
    productIds: ["Product IDs"],
    collectionId: "Collection ID",
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (57)

### `shopify-add-product-to-custom-collection` — Add Products to Custom Collection (Write)

Adds a product or products to a custom collection. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/add-product-to-custom-collection.md

### `shopify-add-tags` — Add Tags (Write)

Add tags. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/add-tags.md

### `shopify-cancel-fulfillment` — Cancel Fulfillment (Write)

Cancels a fulfillment. Run the Search for Orders action and inspect the order's fulfillments to obtain the fulfillment GID. See the documentation.

Full schema: https://pipedream.com/apps/shopify/actions/cancel-fulfillment.md

### `shopify-cancel-fulfillment-order` — Cancel Fulfillment Order (Write)

Cancels a fulfillment order. Run Search for Orders and inspect the order's fulfillment orders to obtain the fulfillment order GID. See the documentation.

Full schema: https://pipedream.com/apps/shopify/actions/cancel-fulfillment-order.md

### `shopify-cancel-order` — Cancel Order (Write)

Cancel an existing order. Run Search for Orders first to obtain the order GID. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/cancel-order.md

### `shopify-create-article` — Create Article (Write)

Create a new blog article. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/create-article.md

### `shopify-create-blog` — Create Blog (Write)

Create a new blog. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/create-blog.md

### `shopify-create-custom-collection` — Create Custom Collection (Write)

Create a new custom collection. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/create-custom-collection.md

### `shopify-create-discount-codes-batch` — Create Discount Codes in Bulk (Write)

Adds multiple discount codes to a price rule in Shopify (up to 100 codes per request). See the documentation.

Full schema: https://pipedream.com/apps/shopify/actions/create-discount-codes-batch.md

### `shopify-create-gift-card` — Create Gift Card (Write)

Creates a new gift card. To supply an optional customer, run Get Customers first to retrieve the customer GID. See the documentation.

Full schema: https://pipedream.com/apps/shopify/actions/create-gift-card.md

### `shopify-create-metafield` — Create Metafield (Write)

Creates a metafield belonging to a resource. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/create-metafield.md

### `shopify-create-metaobject` — Create Metaobject (Write)

Creates a metaobject. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/create-metaobject.md

### `shopify-create-order` — Create Order (Write)

Creates a new order. See the documentation.

Full schema: https://pipedream.com/apps/shopify/actions/create-order.md

### `shopify-create-page` — Create Page (Write)

Create a new page. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/create-page.md

### `shopify-create-product` — Create Product (Write)

Create a new product. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/create-product.md

### `shopify-create-product-variant` — Create Product Variant (Write)

Create a new product variant. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/create-product-variant.md

### `shopify-create-refund` — Create Refund (Write)

Create a refund on an existing order. Run Search for Orders first to obtain the order GID and the line item GIDs to refund. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/create-refund.md

### `shopify-create-return` — Create Return (Write)

Creates a return for an order. See the documentation.

Full schema: https://pipedream.com/apps/shopify/actions/create-return.md

### `shopify-create-smart-collection` — Create Smart Collection (Write)

Creates a smart collection whose membership is defined by conditions (rules). See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/create-smart-collection.md

### `shopify-delete-article` — Delete Article (Write)

Delete an existing blog article. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/delete-article.md

### `shopify-delete-blog` — Delete Blog (Write)

Delete an existing blog. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/delete-blog.md

### `shopify-delete-discount-code` — Delete Discount Code (Write)

Permanently deletes a discount code from a price rule in Shopify. See the documentation.

Full schema: https://pipedream.com/apps/shopify/actions/delete-discount-code.md

### `shopify-delete-metafield` — Delete Metafield (Write)

Deletes a metafield belonging to a resource. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/delete-metafield.md

### `shopify-delete-page` — Delete Page (Write)

Delete an existing page. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/delete-page.md

### `shopify-get-articles` — Get Articles (Read-only)

Retrieve a list of all articles from a blog. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/get-articles.md

### `shopify-get-assigned-fulfillment-orders` — Get Assigned Fulfillment Orders (Read-only)

Retrieve a list of fulfillment orders assigned to a merchant location. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/get-assigned-fulfillment-orders.md

### `shopify-get-customer` — Get Customer (Read-only)

Retrieve a single customer by ID. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/get-customer.md

### `shopify-get-customers` — Get Customers (Read-only)

Retrieve a list of customers. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/get-customers.md

### `shopify-get-discount-code` — Get Discount Code (Read-only)

Retrieves a single discount code that belongs to a price rule in Shopify. Run List Price Rules to find a valid price rule ID and List Discount Codes to find a valid discount code ID. See the documentation.

Full schema: https://pipedream.com/apps/shopify/actions/get-discount-code.md

### `shopify-get-draft-order` — Get Draft Order (Read-only)

Retrieve a single draft order by ID. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/get-draft-order.md

### `shopify-get-draft-orders` — Get Draft Orders (Read-only)

Retrieve a list of draft orders. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/get-draft-orders.md

### `shopify-get-fulfillment` — Get Fulfillment (Read-only)

Retrieve a fulfillment, including tracking info, status, and delivery timestamps. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/get-fulfillment.md

### `shopify-get-fulfillment-order` — Get Fulfillment Order (Read-only)

Retrieve a single fulfillment order by ID. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/get-fulfillment-order.md

### `shopify-get-fulfillment-orders` — Get Fulfillment Orders (Read-only)

Retrieve a list of fulfillment orders. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/get-fulfillment-orders.md

### `shopify-get-metafields` — Get Metafields (Read-only)

Retrieves a list of metafields that belong to a resource. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/get-metafields.md

### `shopify-get-metaobjects` — Get Metaobjects (Read-only)

Retrieves a list of metaobjects. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/get-metaobjects.md

### `shopify-get-pages` — Get Pages (Read-only)

Retrieve a list of all pages. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/get-pages.md

### `shopify-hold-fulfillment-order` — Hold Fulfillment Order (Write)

Places a fulfillment order on hold. Run Search for Orders and inspect the order's fulfillment orders to obtain the fulfillment order GID. See the documentation.

Full schema: https://pipedream.com/apps/shopify/actions/hold-fulfillment-order.md

### `shopify-list-discount-codes` — List Discount Codes (Read-only)

Lists all discount codes for a given price rule in Shopify so you can obtain a valid discount code ID. See the documentation.

Full schema: https://pipedream.com/apps/shopify/actions/list-discount-codes.md

### `shopify-list-price-rules` — List Price Rules (Read-only)

Lists price rules in the Shopify store. See the documentation.

Full schema: https://pipedream.com/apps/shopify/actions/list-price-rules.md

### `shopify-refund-return` — Refund Return (Write)

Processes an existing return in Shopify via the returnProcess mutation, marking the specified return line items as processed. By default no refund is issued — to also issue a refund, include a financialTransfer object with an issueRefund operation (and its required orderTransactions) in Additional…

Full schema: https://pipedream.com/apps/shopify/actions/refund-return.md

### `shopify-bulk-import` — Run Bulk Mutation (Write)

Runs a bulk mutation (Shopify's bulkOperationRunMutation) by uploading a JSONL file of per-line mutation variables, so a mutation (e.g. product/variant/metafield create or update) runs once per line across thousands of records in a single Admin GraphQL bulk operation instead of one API call per…

Full schema: https://pipedream.com/apps/shopify/actions/bulk-import.md

### `shopify-search-custom-collection-by-name` — Search Custom Collection by Name (Read-only)

Search for a custom collection by name/title. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/search-custom-collection-by-name.md

### `shopify-search-orders` — Search for Orders (Read-only)

Search for an order or a list of orders. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/search-orders.md

### `shopify-search-product-variant` — Search for Product Variant (Write)

Search for product variants or create one if not found. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/search-product-variant.md

### `shopify-search-products` — Search for Products (Read-only)

Search for products. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/search-products.md

### `shopify-send-order-invoice` — Send Order Invoice (Write)

Sends an invoice email for an existing order. See the documentation.

Full schema: https://pipedream.com/apps/shopify/actions/send-order-invoice.md

### `shopify-submit-cancellation-request` — Submit Cancellation Request (Write)

Request cancellation of a fulfillment order. This is a fulfillment-service workflow distinct from cancelling the order itself. Run Get Fulfillment Orders first to obtain the fulfillment order GID. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/submit-cancellation-request.md

### `shopify-update-article` — Update Article (Write)

Update a blog article. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/update-article.md

### `shopify-update-discount-code` — Update Discount Code (Write)

Updates the value of an existing discount code belonging to a price rule in Shopify. Run List Price Rules and List Discount Codes to find valid IDs. See the documentation.

Full schema: https://pipedream.com/apps/shopify/actions/update-discount-code.md

### `shopify-update-inventory-level` — Update Inventory Level (Write)

Sets the on-hand inventory level for an inventory item at a location. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/update-inventory-level.md

### `shopify-update-metafield` — Update Metafield (Write)

Updates the value of an existing metafield on a Shopify resource (product, customer, order, etc.) via the metafieldsSet mutation. Use this to change custom data stored on a record you've already identified. Select the owner resource and record, then the specific metafield to update, and provide the…

Full schema: https://pipedream.com/apps/shopify/actions/update-metafield.md

### `shopify-update-metaobject` — Update Metaobject (Write)

Updates a metaobject. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/update-metaobject.md

### `shopify-update-order` — Update Order (Write)

Update an existing order. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/update-order.md

### `shopify-update-page` — Update Page (Write)

Update an existing page. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/update-page.md

### `shopify-update-product` — Update Product (Write)

Update an existing product. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/update-product.md

### `shopify-update-product-variant` — Update Product Variant (Write)

Update an existing product variant. See the documentation

Full schema: https://pipedream.com/apps/shopify/actions/update-product-variant.md

## Triggers (8)

### `shopify-collection-updated` — Collection Updated (Instant) (Instant)

Emit new event whenever a collection is updated, including whenever products are added or removed from a collection.

Full schema: https://pipedream.com/apps/shopify/triggers/collection-updated.md

### `shopify-new-abandoned-cart` — New Abandoned Cart (Polling)

Emit new event each time a user abandons their cart.

Full schema: https://pipedream.com/apps/shopify/triggers/new-abandoned-cart.md

### `shopify-new-article` — New Article (Polling)

Emit new event for each new article in a blog.

Full schema: https://pipedream.com/apps/shopify/triggers/new-article.md

### `shopify-customer-data-request` — New Customer Data Request (Instant)

Emit new customer data requests for data via a GDPR request.

Full schema: https://pipedream.com/apps/shopify/triggers/customer-data-request.md

### `shopify-new-event-emitted` — New Event Emitted (Instant) (Instant)

Emit new event for each new Shopify event.

Full schema: https://pipedream.com/apps/shopify/triggers/new-event-emitted.md

### `shopify-new-page` — New Page (Polling)

Emit new event for each new page published.

Full schema: https://pipedream.com/apps/shopify/triggers/new-page.md

### `shopify-product-added-to-custom-collection` — New product added to custom collection (Polling)

Emit new event each time a product is added to a custom collection.

Full schema: https://pipedream.com/apps/shopify/triggers/product-added-to-custom-collection.md

### `shopify-new-product-created` — New Product Created (Instant) (Instant)

Emit new event for each product added to a store.

Full schema: https://pipedream.com/apps/shopify/triggers/new-product-created.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt