Integration · E-commerce

Connect Claude & ChatGPT to Loop Returns

Ask your AI about returns in Loop: what came in today, what a customer sent back and what they get in return. It can add notes, flag, close, cancel or process returns, look up orders, customers and products synced to Loop, and manage the blocklist and allowlist. It can also check Happy Returns shipments.

Connect Loop Returns free

Free plan, no credit card. Takes about a minute.

Try asking

“Which returns are waiting for review?”
The AI lists returns in the review state for the dates you give, or for the last 24 hours if you give none.
“What is going on with the return for order #10452?”
It looks up the return by order name and shows items, customer, outcome and amounts.
“Add a note that the customer sent photos of the damage.”
It adds an internal note to the return. Notes can be up to 255 characters.

What your AI can do

Returns

List and read returns, add notes, and flag, close, cancel or process a return.

Orders, customers and products

Look up orders, customers, products and variants synced to Loop, and check Happy Returns shipments.

Blocklist and allowlist

Block orders, emails, products or product tags from being returned, and allow orders or emails outside the normal policy.

“Process return 88213.”
It processes the return, which issues the refund, exchange or store credit. This moves money and cannot be undone.
“Block returns from the email [email protected].”
It adds the email to the blocklist, so it can no longer be used to return items.
“Let order #10388 be returned outside the normal policy.”
It adds the order to the allowlist.

128 tools for Loop Returns

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

add_cart_itemChanges dataCreate a new product. Required: variant id. API summary: Add Cart Item.
add_return_noteChanges dataAdd an internal note (up to 255 characters) to a return by `return_id` and `content`.
add_to_allowlistChanges dataAllow returns outside the normal policy for a `type` (order or email) and `value`, i.e. an order number or customer email.
add_to_blocklistChanges dataMake items ineligible for return by blocking a `type` (order, email, product, product_tag) and `value`.
approve_draft_return_return_policyVisible to othersAccept a draft return (draft return id). Has effects visible outside this system. API summary: Accept Return Policy.
attach_orderChanges dataLink a order. API summary: Create Return Deep Link.
attach_product_to_categoryChanges dataAttach a product (product id). API summary: Add Product to Collection.
cancel_draft_returnDeletesCancel a draft return (draft return id). Destructive action; may require approval. API summary: Cancel Draft Return.
cancel_returnDeletesCancel a return by `return_id`. This cannot be undone.
close_returnVisible to othersClose a return by `return_id` without processing it further.
create_addressChanges dataCreate a new address. Required: sales channel, name, status or address. API summary: Create Location.
create_assessChanges dataCreate a new assess. Required: items. API summary: Assess Dispositions.
create_carrierChanges dataCreate a new carrier. Required: return method id or label format. API summary: Select Return Method Carrier.
create_cartChanges dataCreate a new cart. Required: cart. API summary: Create Cart.
create_categoryChanges dataCreate a new category. Required: sales channel or name. API summary: Create Collection.
create_createChanges dataCreate a new create. Required: order id. API summary: Create Draft Return (Declarative).
create_customerChanges dataCreate a new customer. Required: sales channel. API summary: Create Customer.
create_destinationChanges dataCreate a new destination. Required: name, type or address. API summary: Create Destination.
create_draft_returnChanges dataCreate a new draft return. Required: order name or secondary input. API summary: Initialize Draft Return.
create_draft_return_addressChanges dataCreate a new address for a draft return. Required: address1, city, state, country, country code or zip. API summary: Set Address.
create_draft_return_credit_typeChanges dataCreate a new credit type for a draft return. Required: credit type. API summary: Set Credit Type.
create_draft_return_customerChanges dataCreate a new customer for a draft return. Required: email. API summary: Set Customer.
create_draft_return_paymentChanges dataCreate a new payment for a draft return. Required: payment source type or provider intent id. API summary: Create Payment Intent.
create_draft_return_productChanges dataCreate a new product for a draft return. Required: order line item id. API summary: Add Returning Item.
create_draft_return_product_unfinalize_itemsChanges dataCreate a new product for a draft return. API summary: Unfinalize Items.
create_gradeChanges dataCreate a new grade. Required: items. API summary: Grade Items.
create_orderChanges dataCreate a new order. Required: name, sales channel, status, taxes included, total price or line items. API summary: Create Order.
create_productChanges dataCreate a new product for a product. Required: variant id. API summary: Add Returning Item Exchange Item.
create_product_create_productChanges dataCreate a new product. Required: name or sales channel. API summary: Create Product.
create_product_variantChanges dataCreate a new product for a product. Required: name. API summary: Create Product Variant.
create_qrChanges dataCreate a new qr. Required: name or zip. API summary: Create Return Deep Link with QR Code.
create_return_fraud_reportChanges dataCreate a new fraud report for a return. API summary: Create Fraud Report.
create_webhookDeletesCreate a new webhook. Required: topic, trigger or url. Destructive action; may require approval. API summary: Create Webhook.
delete_addressDeletesPermanently delete a address by address id. Destructive action; may require approval. API summary: Delete Location.
delete_allowlistDeletesPermanently delete a allowlist by allowlist id. Destructive action; may require approval. API summary: Delete Allowlist Item.
delete_cartDeletesPermanently delete a cart by cid. Destructive action; may require approval. API summary: Delete Cart.
delete_categoryDeletesPermanently delete a category by category id. Destructive action; may require approval. API summary: Delete Collection.
delete_category_productDeletesPermanently delete a product by product id. Destructive action; may require approval. API summary: Delete Product from Collection.
delete_collection_by_external_idDeletesPermanently delete a product by product id. Destructive action; may require approval. API summary: Delete Collection by External ID.
delete_customerDeletesPermanently delete a customer by customer id. Destructive action; may require approval. API summary: Delete Customer.
delete_customer_by_external_idDeletesPermanently delete a product by product id. Destructive action; may require approval. API summary: Delete Customer by External ID.
delete_destinationDeletesPermanently delete a destination by destination id. Destructive action; may require approval. API summary: Delete Destination.
delete_draft_return_paymentDeletesPermanently delete a payment by payment id. Destructive action; may require approval. API summary: Remove Payment Intent.
delete_draft_return_productDeletesPermanently delete a product by product id. Destructive action; may require approval. API summary: Remove Returning Item.
delete_inventoryDeletesPermanently delete a inventory by location id. Destructive action; may require approval. API summary: Delete Inventory.
delete_inventory_by_external_idsDeletesPermanently delete a product by location external id. Destructive action; may require approval. API summary: Delete Inventory by External IDs.
delete_location_by_external_idDeletesPermanently delete a product by product id. Destructive action; may require approval. API summary: Delete Location by External ID.
delete_orderDeletesPermanently delete a order by order id. Destructive action; may require approval. API summary: Delete Order.
delete_order_by_external_idDeletesPermanently delete a product by product id. Destructive action; may require approval. API summary: Delete Order by External ID.
delete_productDeletesPermanently delete a product by cart item id. Destructive action; may require approval. API summary: Remove Cart Item.
delete_product_by_external_idDeletesPermanently delete a product by product id. Destructive action; may require approval. API summary: Delete Product by External ID.
delete_product_delete_productDeletesPermanently delete a product by product id. Destructive action; may require approval. API summary: Delete Product.
delete_product_variantDeletesPermanently delete a product by product id 2. Destructive action; may require approval. API summary: Delete Product Variant.
delete_product_variant_by_external_idDeletesPermanently delete a product by external id. Destructive action; may require approval. API summary: Delete Product Variant by External ID.
delete_return_fraud_reportsMoves moneyPermanently delete a fraud report by return id. Financial or irreversible action; may require approval. API summary: Delete Fraud Report.
delete_return_removesDeletesPermanently delete a remove by return id. Destructive action; may require approval. API summary: Remove Line Items.
delete_webhookDeletesPermanently delete a webhook by webhook id. Destructive action; may require approval. API summary: Delete Webhook.
flag_returnChanges dataFlag a return for review by `return_id`.
get_addressGet one address by address id. API summary: Get Location.
get_allowlistGet one allowlist by allowlist id. API summary: Get Allowlist Item.
get_blocklistGet one blocklist by blocklist id. API summary: Get Blocklist Item.
get_bulk_operationGet one bulk operation by bulk operation id. API summary: Get Bulk Operation.
get_cartGet one cart by cid. API summary: Get Cart.
get_categoryGet one category by category id. API summary: Get Collection.
get_collection_by_external_idGet one product by product id. API summary: Get Collection by External ID.
get_customerGet one customer by Loop `customer_id`.
get_customer_by_external_idGet one product by product id. API summary: Get Customer by External ID.
get_destinationGet one destination by destination id. API summary: Get Destination Details.
get_draft_returnGet one draft return by draft return id. API summary: Get Draft Return.
get_happy_returns_shipmentGet one Happy Returns shipment by `happy_returns_shipment_id`.
get_inventoryGet one inventory by location id. API summary: Get Inventory.
get_inventory_by_external_idsGet one product by location external id. API summary: Get Inventory by External IDs.
get_location_by_external_idGet one product by product id. API summary: Get Location by External ID.
get_orderGet one order by its Loop `order_id`, with line items, customer and totals.
get_productGet one product by Loop `product_id`.
get_product_2Get one product by product id. API summary: Get Order by External ID.
get_product_by_external_idGet one product by product id. API summary: Get Product by External ID.
get_product_variantGet one product for a product by product id 2. API summary: Get Product Variant.
get_product_variant_by_external_idGet one product for a product by external id. API summary: Get Product Variant by External ID.
get_return_detailsGet full details of a return by `return_id`, or look it up by `order_id` or `order_name`: items, customer, outcome and amounts.
list_addressesList addresses. Optional filters: external id or sort order. Results are paginated. API summary: List Locations.
list_allowlistList allowlist entries that are allowed to return outside the normal policy.
list_asnsList asns. Optional filters: from or to. API summary: Advanced Shipping Notice.
list_blocklistList blocklist entries: orders, emails, products or product tags that cannot be returned.
list_bulk_operation_projectsList projects for a bulk operation. Optional filters: sort order. Results are paginated. API summary: List Bulk Operation Jobs.
list_bulk_operationsList bulk operations. Optional filters: sort order. Results are paginated.
list_categoriesList categories. Optional filters: external id or sort order. Results are paginated. API summary: List Collections.
list_customersList customers synced to Loop, with paging and optional `external_id`.
list_destinationsList destinations. API summary: Get All Destinations.
list_draft_return_totalsList totals for a draft return. API summary: Get Draft Return Totals.
list_draft_returnsList draft returns. API summary: List Draft Returns (HAL-Forms).
list_happy_returns_shipmentsList Happy Returns shipments in a date range (`from`, `to`).
list_inventoriesList inventories. Optional filters: location id, product variant id or sort order. Results are paginated.
list_ordersList orders synced to Loop, with paging and optional `external_id`.
list_product_variantsList the variants of a product (`product_id`), optionally by `barcode` or IDs.
list_productsList products synced to Loop, filtered by `tags`, `barcode` or `external_id`.
list_products_2List products. Results are paginated. API summary: List Order Line Items.
list_return_notesList the notes on a return (`return_id`).
list_returnsList returns in a date range (`from`, `to`), optionally by `state` (open, closed, cancelled, expired, review). Without dates it covers the last 24 hours.
list_samplesList samples. Optional filters: topic, trigger or is zapier. API summary: Get Sample Webhook.
list_shipment_productsList products for a shipment. Results are paginated. API summary: Get Shipment Items.
list_webhooksList webhooks. API summary: Get Webhooks.
process_returnChanges dataProcess a return by `return_id`, which issues its refund, exchange or store credit. This moves money and cannot be undone.
remove_from_blocklistDeletesRemove a blocklist entry by `blocklist_id`.
submit_draft_returnVisible to othersSubmit a draft return (draft return id). Has effects visible outside this system. API summary: Submit Draft Return.
submit_draft_return_itemsVisible to othersFinalize a draft return (draft return id). Has effects visible outside this system. API summary: Finalize Items.
submit_draft_return_methodVisible to othersReturn a draft return (draft return id). Has effects visible outside this system. API summary: Select Return Method.
submit_product_reasonVisible to othersReturn a product (returning item id). Has effects visible outside this system. API summary: Set Returning Item Return Reason.
submit_product_typeVisible to othersReturn a product (returning item id). Has effects visible outside this system. API summary: Set Returning Item Return Type.
update_addressChanges dataUpdate an existing address identified by address id. Only the fields you pass are changed. API summary: Update Location.
update_addressesVisible to othersUpdate an existing address. Has effects visible outside this system. API summary: Upsert Location.
update_cartChanges dataUpdate an existing cart identified by cid. API summary: Update Cart.
update_categoriesVisible to othersUpdate an existing category. Has effects visible outside this system. API summary: Upsert Collection.
update_categoryChanges dataUpdate an existing category identified by category id. Only the fields you pass are changed. API summary: Update Collection.
update_customerChanges dataUpdate an existing customer identified by customer id. Only the fields you pass are changed. API summary: Update Customer.
update_customersVisible to othersUpdate an existing customer. Has effects visible outside this system. API summary: Upsert Customer.
update_destinationChanges dataUpdate an existing destination identified by destination id. API summary: Update Destination.
update_inventoryChanges dataUpdate an existing inventory identified by location id. Only the fields you pass are changed. API summary: Upsert Inventory.
update_orderChanges dataUpdate an existing order identified by order id. API summary: Update Order.
update_ordersVisible to othersUpdate an existing order. Has effects visible outside this system. API summary: Upsert Order.
update_productChanges dataUpdate an existing product identified by product id. Only the fields you pass are changed. API summary: Update Product.
update_product_upsert_inventory_by_external_idsChanges dataUpdate an existing product identified by location external id. API summary: Upsert Inventory by External IDs.
update_product_user_inputChanges dataUpdate an existing user input identified by user input id. API summary: Add Returning Item User Input.
update_product_variantChanges dataUpdate an existing product identified by product id 2. Only the fields you pass are changed. API summary: Update Product Variant.
update_productsVisible to othersUpdate an existing product. Has effects visible outside this system. API summary: Upsert Product.
update_products_upsert_product_variantVisible to othersUpdate an existing product identified by product id. Has effects visible outside this system. API summary: Upsert Product Variant.
update_products_upsert_product_variant_by_product_external_idVisible to othersUpdate an existing product identified by product external id. Has effects visible outside this system. API summary: Upsert Product Variant by Product External ID.
update_webhookDeletesUpdate an existing webhook identified by webhook id. Only the fields you pass are changed. Destructive action; may require approval. API summary: Update Webhook.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose Loop Returns from the app list.
2
Paste your key
Paste a Loop API key. You need Loop Plus or the Loop Integrations add-on. In the Loop Admin go to Returns Management > Tools & integrations > Developer Tools, click Generate API key and tick the scopes the AI should use, for example Returns, Orders and Carts. Name the key, click Generate and copy it.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Loop Returns?

The AI can list and read returns and their notes, orders, customers, products and variants, the blocklist and allowlist, and Happy Returns shipments. It can add notes, flag, close, cancel and process returns, add and remove blocklist entries and add allowlist entries.

Does the AI see my Loop Returns API key?

No. Your Loop Returns credentials are encrypted at rest and never shown to the AI. After you save them, they are not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start read-only. Processing a return issues a refund, exchange or store credit, and cancelling a return cannot be undone. Both can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

HeyMyApps has a free plan with no credit card required. Paid plans bill per completed task. You also need your own Loop Returns account.

Why do some tools return a 401 error?

Loop API keys are scoped. If your key does not include a scope that a tool needs, for example Orders, Loop returns a 401 error for that tool. Generate a key with the scopes for the tools you switch on in HeyMyApps.