Hermes and Shopify

Connect Hermes to Shopify

Give your Hermes agent access to Shopify in Melso — 315 tools it can call while it works through a task.

Set it up in Melso

1In Melso, open Settings → Agent Apps and hit Connect on Shopify.
2Finish the API_KEY / OAUTH2 sign-in in the window that opens. Melso stores the connection, not your credentials.
3Open your Hermes agent, go to its Agent Apps tab, and allow Shopify.
4Give the agent a task. It calls Shopify itself when the work needs it.

Get Melso

What you get

What Shopify gives your agent

The tools, permissions, and events Shopify exposes — the same ones your agent can use once the app is authorized.

What you sign in with

Shopify connects with API_KEY / OAUTH2.

Client id
Client secret

Permissions

read_productswrite_productsread_orderswrite_ordersread_customerswrite_customersread_inventorywrite_inventoryread_fulfillmentswrite_fulfillments

Tools Shopify exposes

SHOPIFY_ACTIVATE_ONE_TIME_CHARGE

Activate One-Time Charge

Activate a one-time application charge in Shopify. Use when you need to finalize billing for an accepted charge. DEPRECATED: This endpoint is deprecated as of API version 2021-01. One-time charges are now immediately activated when approved by a merchant, making this activation step no longer required for newer API versions.

SHOPIFY_ADD_PRODUCT_TO_COLLECTION

Add product to custom collection (Deprecated)

DEPRECATED: Use SHOPIFY_ADDS_A_PRODUCT_TO_A_CUSTOM_COLLECTION instead. Adds a product to an existing *custom collection*, optionally specifying its `position` if the collection is manually sorted.

SHOPIFY_ADD_PRODUCT_TO_CUSTOM_COLLECTION

Add product to custom collection

Add a product to a custom collection by creating a collect resource. Use when you need to link a product to a custom collection. Note: Can only add products to custom collections, not smart collections.

SHOPIFY_ADJUST_INVENTORY_LEVEL

Adjust inventory levels

Adjust the inventory level of an inventory item at a single location. Use when you need to increase or decrease stock quantities at a specific location.

SHOPIFY_APPLY_FULFILLMENT_HOLD

Apply fulfillment hold

Applies a fulfillment hold to an open fulfillment order, halting all fulfillment work. Use when you need to pause fulfillment due to payment issues, fraud concerns, address problems, or inventory shortages. The fulfillment order status will change to on_hold, preventing any fulfillment work from proceeding until the hold is released.

SHOPIFY_APPROVE_COMMENT

Approve a comment

Approves a pending comment and publishes it to a blog article, making it publicly visible to readers. This action changes the comment's status from 'pending' or 'unapproved' to 'published' and sets the published_at timestamp. Use this when moderating blog comments that require approval before appearing on the storefront. Requires the 'write_content' scope.

SHOPIFY_BULK_CREATE_PRODUCTS

Bulk create products via GraphQL

Creates many products (20-50+) in one asynchronous Shopify bulk mutation job. Uses stagedUploadsCreate for JSONL upload, then bulkOperationRunMutation with productCreate, polling until completion and returning per-row success/errors.

SHOPIFY_BULK_DELETE_CUSTOMER_ADDRESSES

Bulk delete customer addresses (Deprecated)

Bulk delete multiple customer addresses in a single operation. This action permanently removes several addresses from a customer's address book at once, which is more efficient than deleting addresses one by one. Use this when you need to clean up multiple invalid or outdated addresses for a customer. Requires the 'write_customers' scope and access to protected customer data.