Skip to main content

Shopify Integration - Setup Guide

Connect your Shopify store to Goodweek to manage products, orders, customers, inventory, and discounts directly from your AI workspace.

A
Written by Antoine Stempien

Connect your Shopify store to Goodweek to manage products, orders, customers, inventory, and discounts directly from your AI workspace.

ℹ️ Governance note

Goodweek will never exceed the access levels granted to the user within Shopify, guaranteeing alignment with your organization's governance policies. Outcomes and available features may vary depending on each user's specific permissions and authenticated access.

📋 Prerequisites

Before any user can see and connect the Shopify integration, your organization admin must first enable it from the Goodweek Admin Panel under the Integrations tab.

Admin Setup

The Shopify integration uses OAuth 2.0 and does not require any admin-level approval within Shopify before connecting.

⚠️ Store name format

When connecting, you will be asked for your Shopify store name. Enter only the store name prefix (e.g. yourstore), not the full URL. Goodweek will automatically construct the correct Shopify domain.

User Connection

  1. In Goodweek, go to Integrations.

  2. Find Shopify and click Connect.

  3. Enter your store name (e.g. yourstore) and click Continue.

  4. You will be redirected to Shopify, where you will be asked to sign in and authorize access.

  5. Click Install app to grant access and return to Goodweek.

Important Notes

  • Each user must connect their own store individually. If you manage multiple stores, you will need a separate connection for each.

  • Goodweek can only access the data and resources that your Shopify store account has permission to see.

  • You can revoke Goodweek's access at any time from Shopify Admin → Settings → Apps and sales channels → Composio → Delete.


Available Tools

Tool

Description

Type

Get Orders with Filters

Retrieves Shopify orders filtered by dates, status, and other parameters with pagination.

Read

Get Order

Retrieves a specific order by its unique ID with full details including line items and shipping.

Read

Create an Order

Creates a fully committed order in Shopify without payment processing.

Write

Create Order Refund

Creates a refund for a Shopify order. Requires calculating the refund first.

Write

Get Refunds for Order

Lists all refunds for a specific order.

Read

Get Order Risks

Retrieves all fraud risk assessments for a specific order.

Read

Get Order Fulfillments

Retrieves fulfillments (shipments) associated with a specific order.

Read

Create Fulfillment

Creates a fulfillment for one or more fulfillment orders, completing the shipping process.

Write

Create Fulfillment Event

Creates a tracking event for a fulfillment to update shipment status.

Write

Get Fulfillment Events

Retrieves all tracking events for a specific fulfillment.

Read

Get Fulfillment Orders for Order

Lists fulfillment orders for a specific Shopify order.

Read

Get Customer Orders

Retrieves all orders for a specific customer.

Read

Search Customers

Searches for customers matching a supplied query in the store.

Read

Retrieve a Single Customer

Retrieves detailed information about a specific customer by their ID.

Read

Create Customer

Creates a new customer record in the Shopify store.

Write

Get Customer Addresses

Retrieves all addresses associated with a specific customer.

Read

Count Customers

Retrieves a count of all customers, optionally filtered.

Read

Retrieve Count of Products

Retrieves the total number of products in the store with optional filters.

Read

Get Custom Collections

Retrieves a list of custom (manual) collections from the store.

Read

Create a Custom Collection

Creates a new manually curated collection in Shopify.

Write

Get Inventory Levels

Retrieves inventory levels for specified items and locations.

Read

Adjust Inventory Levels

Adjusts the inventory level of an inventory item at a single location.

Read

Get Inventory Items

Retrieves a list of inventory items by specified IDs.

Read

Get Locations Count

Returns the total count of locations configured in the Shopify store.

Read

Get Location

Retrieves details about a specific physical or virtual location by its ID.

Read

Create Price Rule

Creates a price rule defining discount logic (percentage, fixed amount, buy X get Y, etc.).

Write

Create Discount Code

Creates a discount code linked to an existing price rule.

Write

Get Discount Code

Retrieves details for a specific discount code associated with a price rule.

Read

Create a Draft Order

Creates a draft order using product variant line items, ready for completion.

Write

Receive a Single Draft Order

Retrieves detailed information for a specific draft order.

Read

Complete a Draft Order

Finalizes a draft order and transitions it to an actual order.

Read

Create a New Page

Creates a static web page in Shopify for long-term content.

Write

Create Article

Creates an article for a blog in Shopify.

Write

Create a New Blog

Creates a new blog in the Shopify store.

Write

Get Countries

Retrieves a list of countries configured in the store with tax rates.

Read

Create a Metafield

Creates a metafield to attach custom metadata to any Shopify resource.

Write

Cancel an Order

Cancels a Shopify order with optional restocking and email notification.

⚠️ Destructive

Delete an Order

Permanently deletes an order from Shopify. Only test orders or orders paid manually can be deleted.

⚠️ Destructive

Delete a Customer

Permanently deletes a customer who has no existing orders.

⚠️ Destructive

Delete a Product

Permanently deletes a product from the store. This action is irreversible.

⚠️ Destructive

Delete a Draft Order

Permanently deletes a draft order from Shopify.

⚠️ Destructive

Use Cases

  • Review orders and fulfilment status. Retrieve orders by date or status, check fulfilment tracking events, and look up specific order details from Goodweek to stay on top of customer shipments without navigating Shopify admin.

  • Manage customers and their order history. Search for customers, view their contact details and addresses, and retrieve their order history from Goodweek to support customer service conversations.

  • Create discount codes and price rules. Set up new promotional price rules and generate discount codes directly from Goodweek for campaigns or customer-specific offers.

  • Monitor and adjust inventory. Check inventory levels across locations and adjust stock counts for specific items from Goodweek without accessing Shopify admin directly.


Troubleshooting

Cannot find the store during connection

Make sure you are entering only the store name prefix (e.g. yourstore), not the full URL like yourstore.myshopify.com.

Integration not visible in Goodweek

Make sure your organization admin has enabled the Shopify integration from the Goodweek Admin Panel under the Integrations tab.

References

Did this answer your question?