Shopify

The "Shopify Integration" step allows you to connect your AirOps workflows directly with your Shopify store. This powerful integration enables you to create, update, and retrieve products, collections, blog articles, and other content from your Shopify e-commerce platform.

How to Configure the Shopify Integration Step

Configuring the step requires setting the parameters shown below:

[IMAGE: Screenshot of the Shopify Integration step configuration panel]

Authentication

Before using the Shopify integration in your workflows, you must first connect your Shopify store in the AirOps Settings:

1. Navigate to ⚙ Settings > Integrations

2. Find the Shopify section and click "Configure"

3. Enter your Shopify store URL (e.g., "your-store.myshopify.com")

4. Complete the OAuth authentication process by granting AirOps the necessary permissions

Action Type

Select the specific Shopify action you want to perform:

• Create Blog Article: Add a new article to your Shopify blog

• Update Blog Article: Modify an existing article in your Shopify blog

• Get Blog Article: Retrieve a specific article from your Shopify blog

• List Blog Articles: Get a list of articles from your Shopify blog

• Create Product: Add a new product to your Shopify store

• Update Product: Modify an existing product in your Shopify store

• Get Product: Retrieve a specific product from your Shopify store

• List Products: Get a list of products from your Shopify store

Action-Specific Parameters

Create Blog Article

• Blog ID: The ID of the blog where you want to create the article

• Title: The title of the blog article

• Author: The name of the article's author

• Content (HTML): The body content of the article in HTML format

• Summary (Optional): A summary or excerpt of the article

• Tags (Optional): Comma-separated tags for the article

• Published (Optional): Set to "true" to publish immediately, or "false" to save as draft

• Image URL (Optional): Featured image URL for the article

Update Blog Article

• Article ID: The ID of the article you want to update

• Title (Optional): New title for the article

• Author (Optional): New author name for the article

• Content (Optional): New HTML content for the article

• Summary (Optional): New summary or excerpt

• Tags (Optional): New comma-separated tags

• Published (Optional): Change publication status ("true"/"false")

• Image URL (Optional): New featured image URL

Get Blog Article

• Article ID: The ID of the article you want to retrieve

List Blog Articles

• Blog ID: The ID of the blog to retrieve articles from

• Limit (Optional): Maximum number of articles to return

• Published Status (Optional): Filter by publication status ("any", "published", "unpublished")

• Since ID (Optional): Return articles after the specified ID

Create Product

• Title: The name of the product

• Description: Detailed product description (supports HTML)

• Product Type: Category or type of product

• Vendor (Optional): The manufacturer or brand

• Tags (Optional): Comma-separated tags for the product

• Price (Optional): The product's price

• Compare-at Price (Optional): Original price for showing discounts

• SKU (Optional): Stock keeping unit code

• Inventory Quantity (Optional): Available stock quantity

• Weight (Optional): Product weight

• Images (Optional): JSON array of image URLs

• Published (Optional): Set to "true" to make visible, "false" to hide

Update Product

• Product ID: The ID of the product you want to update

• Title (Optional): New product name

• Description (Optional): New product description

• Product Type (Optional): New product category or type

• Vendor (Optional): New manufacturer or brand

• Tags (Optional): New comma-separated tags

• Price (Optional): Updated product price

• Compare-at Price (Optional): Updated original price

• SKU (Optional): Updated stock keeping unit code

• Inventory Quantity (Optional): Updated stock quantity

• Weight (Optional): Updated product weight

• Images (Optional): Updated JSON array of image URLs

• Published (Optional): Update visibility ("true"/"false")

Get Product

• Product ID: The ID of the product you want to retrieve

List Products

• Limit (Optional): Maximum number of products to return

• Collection ID (Optional): Filter products by collection

• Product Type (Optional): Filter by product type

• Vendor (Optional): Filter by vendor/brand

• Published Status (Optional): Filter by publication status

• Since ID (Optional): Return products after the specified ID

Output Format

The Shopify Integration step returns a JSON object with the result of your action. The format varies depending on the action performed:

Create/Update/Get Blog Article Example

{
  "article": {
    "id": 12345678901,
    "title": "How to Optimize Your E-commerce Site for Conversions",
    "author": "Jane Smith",
    "blog_id": 23456789012,
    "created_at": "2025-02-20T15:30:22Z",
    "updated_at": "2025-02-20T15:30:22Z",
    "published_at": "2025-02-20T15:30:22Z",
    "summary_html": "Learn the essential strategies for improving your e-commerce conversion rates.",
    "handle": "how-to-optimize-your-e-commerce-site-for-conversions",
    "tags": "conversion optimization, e-commerce tips, user experience",
    "admin_graphql_api_id": "gid://shopify/Article/12345678901",
    "image": {
      "created_at": "2025-02-20T15:30:22Z",
      "alt": "E-commerce conversion optimization",
      "width": 1200,
      "height": 627,
      "src": "https://cdn.shopify.com/s/files/1/0123/4567/8901/articles/ecommerce-conversion.jpg"
    }
  }
}

List Blog Articles Example

{
  "articles": [
    {
      "id": 12345678901,
      "title": "How to Optimize Your E-commerce Site for Conversions",
      "author": "Jane Smith",
      "blog_id": 23456789012,
      "created_at": "2025-02-20T15:30:22Z",
      "published_at": "2025-02-20T15:30:22Z",
      "tags": "conversion optimization, e-commerce tips, user experience"
    },
    {
      "id": 12345678902,
      "title": "5 Product Photography Tips for Online Stores",
      "author": "John Davis",
      "blog_id": 23456789012,
      "created_at": "2025-02-15T10:15:45Z",
      "published_at": "2025-02-15T10:15:45Z",
      "tags": "product photography, image optimization, visual merchandising"
    }
  ]
}

[IMAGE: Screenshot showing an example of the Shopify Integration results in the AirOps interface]

How to Use the Results

You can access the Shopify data in subsequent workflow steps using Liquid syntax. For example:

To access a created article's ID:

{{ step_2.output.article.id }}

To access a list of articles:

{{ step_2.output.articles }}

To loop through a list of products in an LLM prompt:

{% for product in step_2.output.products %}
- {{ product.title }} ({{ product.price }})
{% endfor %}

Common Use Cases

• Creating and updating product descriptions at scale

• Generating SEO-optimized blog content for your store

• Updating product pricing based on market analysis

• Creating personalized product collections

• Building custom product recommendation systems

• Generating product variants with AI assistance

• Automating content creation for seasonal promotions

How to Continue if the Integration Fails

By default, the Shopify Integration step will terminate the workflow if it fails. To continue the workflow if the step fails, click "Continue" at the bottom of the settings panel.

[IMAGE: Screenshot showing the "Continue" option in the step settings]

The step will return the following keys when it fails:

• output: this will be null

• error:

  • message: the message returned from the step

  • code: the error code representing the error

Common error causes include:

• Invalid authentication

• Missing required fields

• Rate limits exceeded

• Resource not found

Example Workflow

Here's a common pattern using the Shopify Integration step:

1. Start with product data (name, description, price, etc.)

2. Use an LLM step to generate an optimized product description with features and benefits

3. Use another LLM step to generate SEO metadata (title, meta description)

4. Use the "Search Stock Images" step to find relevant product imagery

5. Use the "Shopify Integration" step to create or update the product with all generated content

This workflow enables you to automate the creation and optimization of product listings in your Shopify store, ensuring consistent, high-quality content that drives conversions and improves search visibility.