Integration

Returnless integration

Returnless is a returns management platform for online shops. Look up return orders with their items, shipments, notes, tags, attachments, payment transactions and refunds; approve or reject a return, change its status, add items, shipments, notes and tags; start a return for a shop order through a return-order intent; and read the account's sales orders, customers, products, forms, return reasons, statuses, coupons and users, or manage webhook subscriptions. Creating or editing note templates, shipping instructions, return instructions and email templates is not exposed (the vendor documents no body for those routes); reading and deleting them is. Authentication is an API key created in the Returnless app, sent as a Bearer token in the Authorization header.

Connect Returnless How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Returnless.Built from the 112 Returnless tools below, on the connection you add once.

What you can do with Returnless

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Tag, 8 operations

attach_return_order_tagsAttach return order tagsPOSTAttaches tags to a return order object.
create_tagCreate tagPOSTCreates a new tags object.
delete_tagDelete tagDELETEDeletes a tag object.
detach_return_order_tagsDetach return order tagsDELETEDetaches tags from a return order object.
get_tagGet tagGETRetrieves a tag object.
list_return_order_tagsList return order tagsGETReturn a list of tags of a return order. The tags are returned sorted by creation date, with the most recent tags appearing first.
list_tagsList tagsGETReturn a list of your tags. The tags are returned sorted by creation date, with the most recent tags appearing first.
update_tagUpdate tagPATCHUpdates a tag object.

Note, 7 operations

add_return_order_item_noteAdd return order item notePOSTAdds a note to a return order item object.
add_return_order_noteAdd return order notePOSTAdds a note to a return order object.
delete_noteDelete noteDELETEDeletes a note object.
get_noteGet noteGETRetrieves a note object.
list_notesList notesGETReturn a list of your notes. The notes are returned sorted by creation date, with the most recent notes appearing first.
list_return_order_item_notesList return order item notesGETList all notes of a return order item
list_return_order_notesList return order notesGETList all notes of a return order

Webhook subscription, 5 operations

create_webhook_subscriptionCreate webhook subscriptionPOSTSubscribes an HTTPS endpoint to Returnless events (return, request, shipment and depreciation events). Returns the subscription.
delete_webhook_subscriptionDelete webhook subscriptionDELETEDeletes a webhook subscriptions object.
get_webhook_subscriptionGet webhook subscriptionGETRetrieves a webhook subscriptions object.
list_webhook_subscriptionsList webhook subscriptionsGETReturn a list of your webhook subscriptions. The webhook subscriptions are returned sorted by creation date, with the most recent webhook subscriptions appearing first.
update_webhook_subscriptionUpdate webhook subscriptionPATCHUpdates a webhook subscription object.

Depreciation, 4 operations

add_return_order_item_depreciationAdd return order item depreciationPOSTAdds a depreciation to a return order item object.
list_depreciationsList depreciationsGETReturn a list of your depreciations. The depreciations are returned sorted by creation date, with the most recent depreciations appearing first.
list_return_order_depreciationsList return order depreciationsGETReturn a list of depreciations of a return order. The depreciations are returned sorted by creation date, with the most recent depreciations appearing first.
update_depreciationUpdate depreciationPATCHUpdates a depreciation object.

Return address, 4 operations

create_return_addressCreate return addressPOSTCreates a new return address object.
get_return_addressGet return addressGETRetrieves a return address object.
list_return_addressesList return addressesGETReturn a list of your return addresses. The return addresses are returned sorted by creation date, with the most recent return addresses appearing first.
update_return_addressUpdate return addressPATCHUpdates a return address object.

Return order, 4 operations

create_return_orderCreate return orderPOSTCreates a return order from a return-order intent that did not fail (create_return_order_intent): the customer's address, the order items to return with quantity and return reason, optional tags and metadata.
get_return_orderGet return orderGETRetrieves a return order object.
list_customer_return_ordersList customer return ordersGETReturn a list of return orders of a customer. The return orders are returned sorted by creation date, with the most recent return orders appearing first.
list_return_ordersList return ordersGETReturn a list of your return orders. The return orders are returned sorted by creation date, with the most recent return orders appearing first.

Shipment, 4 operations

add_return_order_shipmentAdd return order shipmentPOSTAdds a shipment to a return order object.
get_shipmentGet shipmentGETRetrieves a shipment object.
list_return_order_shipmentsList return order shipmentsGETList all shipments of a return order
list_shipmentsList shipmentsGETReturn a list of your shipments. The shipments are returned sorted by creation date, with the most recent shipments appearing first.

Attachment, 3 operations

get_attachmentGet attachmentGETRetrieves an attachment object.
list_attachmentsList attachmentsGETReturn a list of your attachments. The attachments are returned sorted by creation date, with the most recent attachments appearing first.
list_return_order_attachmentsList return order attachmentsGETReturns a list of all attachments associated with the return order, including attachments stored on its items, question answers, notes, shipment investigation requests and insurances.

Item, 3 operations

add_return_order_itemAdd return order itemPOSTAdds an item to a return order object.
list_return_order_itemsList return order itemsGETList all items of a return order
list_sales_order_itemsList sales order itemsGETReturn a list of items of a sales order. The items are returned sorted by creation date, with the most recent items appearing first.

Note template, 3 operations

delete_note_templateDelete note templateDELETEDeletes a note template object.
get_note_templateGet note templateGETRetrieves a note template object.
list_note_templatesList note templatesGETReturn a list of your note templates. The note templates are returned sorted by creation date, with the most recent note templates appearing first.

Payment transaction, 3 operations

get_payment_transactionGet payment transactionGETRetrieves a payment transaction object.
list_payment_transactionsList payment transactionsGETReturn a list of your payment transactions. The payment transactions are returned sorted by creation date, with the most recent payment transactions appearing first.
list_return_order_payment_transactionsList return order payment transactionsGETList all payment transactions of a return order

Request status, 3 operations

get_request_statusGet request statusGETRetrieves a request status object.
list_request_statusesList request statusesGETReturn a list of your request statuses. The request statuses are returned sorted by creation date, with the most recent request statuses appearing first.
update_request_statusUpdate request statusPATCHUpdates a request status object.

Return instruction, 3 operations

delete_return_instructionDelete return instructionDELETEDeletes a return instruction object.
get_return_instructionGet return instructionGETRetrieves a return instruction object.
list_return_instructionsList return instructionsGETReturn a list of your return instructions. The return instructions are returned sorted by creation date, with the most recent return instructions appearing first.

Return status, 3 operations

get_return_statusGet return statusGETRetrieves a return status object.
list_return_statusesList return statusesGETReturn a list of your return statuses. The return statuses are returned sorted by creation date, with the most recent return statuses appearing first.
update_return_statusUpdate return statusPATCHUpdates a return status object.

Sales order, 3 operations

get_sales_orderGet sales orderGETRetrieves a sales order object.
list_return_order_sales_ordersList return order sales ordersGETRetrieves a paginated list of sales orders associated with a return order.
list_sales_ordersList sales ordersGETReturn a list of your sales orders. The sales orders are returned sorted by creation date, with the most recent sales orders appearing first.

Shipping instruction, 3 operations

delete_shipping_instructionDelete shipping instructionDELETEDeletes a shipping instruction object.
get_shipping_instructionGet shipping instructionGETRetrieves a shipping instruction object.
list_shipping_instructionsList shipping instructionsGETReturn a list of your shipping instructions. The shipping instructions are returned sorted by creation date, with the most recent shipping instructions appearing first.

Status, 3 operations

add_shipment_statusAdd shipment statusPOSTAdds a new status to the shipment object.
list_shipment_statusesList shipment statusesGETReturn a list statuses of a shipment. The statuses are returned sorted by creation date, with the most recent status appearing first.
update_return_order_statusUpdate return order statusPATCHSets the return status of a return order to one of the account's return statuses (status_id from list_return_statuses) and returns the updated return order.

Category, 2 operations

get_categoryGet categoryGETRetrieves a category object.
list_categoriesList categoriesGETReturn a list of your categories. The categories are returned sorted by creation date, with the most recent categories appearing first.

Coupon, 2 operations

get_couponGet couponGETRetrieves a coupon object.
list_couponsList couponsGETReturn a list of your coupons. The coupons are returned sorted by creation date, with the most recent coupons appearing first.

Customer, 2 operations

get_customerGet customerGETRetrieves a customer object.
list_customersList customersGETReturn a list of your customers. The customers are returned sorted by creation date, with the most recent customers appearing first.

Email template, 2 operations

get_email_templateGet email templateGETRetrieves a email template object.
list_email_templatesList email templatesGETReturn a list of your email templates. The email templates are returned sorted by creation date, with the most recent email templates appearing first.

Form, 2 operations

get_formGet formGETRetrieves a form object.
list_formsList formsGETReturn a list of your forms. The forms are returned sorted by creation date, with the most recent forms appearing first.

Meta data, 2 operations

get_return_order_meta_dataGet return order meta dataGETList all meta-data of a return order
update_return_order_meta_dataUpdate return order meta dataPUTReplaces the metadata of a return order with the given key/value pairs and returns the stored list.

Platform, 2 operations

get_platform_integrationGet platform integrationGETRetrieves a platform integration object.
list_platform_integrationsList platform integrationsGETReturn a list of platform-integrations. The platform-integrations are returned sorted by creation date, with the most recent platform-integrations appearing first.

Product, 2 operations

get_productGet productGETRetrieves a product object.
list_productsList productsGETReturn a list of your products. The products are returned sorted by creation date, with the most recent products appearing first.

Question, 2 operations

list_form_questionsList form questionsGETReturn a list of questions of a form. The questions are returned sorted by creation date, with the most recent questions appearing first.
list_return_order_questionsList return order questionsGETRetrieves a paginated list of questions and answers associated with a return order.

Refund, 2 operations

get_refundGet refundGETRetrieves a refund object.
list_refundsList refundsGETReturn a list of all credit invoices (refunds) associated with the tenant. The credit invoices are returned with their related return orders and return order items and sorted by creation date, with the most recent first.

Return order intent, 2 operations

create_return_order_intentCreate return order intentPOSTStarts a return for a shop order on a return form: give the order number and the value the form checks it against (input, such as the customer's email or postal code). Its id feeds create_return_order.
get_return_order_intentGet return order intentGETRetrieves a return-order intent object.

Return reason, 2 operations

list_form_return_reasonsList form return reasonsGETReturn a list of return reasons of a form. The return reasons are returned sorted by creation date, with the most recent return reasons appearing first.
list_return_reasonsList return reasonsGETReturn a list of return reasons available in Returnless. The return reasons are returned sorted alphabetically by system name.

Shipment investigation request, 2 operations

get_shipment_investigation_requestGet shipment investigation requestGETRetrieves a shipment investigation request object.
list_shipment_investigation_requestsList shipment investigation requestsGETReturn a list of your shipping investigation request by shipment.

User, 2 operations

get_userGet userGETRetrieves a user object.
list_usersList usersGETReturn a list the users attached to your account. The users are returned sorted by creation date, with the most recent users appearing first.

Account, 1 operation

get_accountGet accountGETReturn the current account information.

Address, 1 operation

list_customer_addressesList customer addressesGETReturn a list of addresses of a customer. The addresses are returned sorted by creation date, with the most recent addresses appearing first.

Approve, 1 operation

approve_return_orderApprove return orderPOSTApproves a return order that is in the request state. approval_method approve creates the shipment, approve_without_shipment skips it, approve_with_manual_shipment records one you give (return_address_id, tracking_number, tracking_url).

Automation, 1 operation

list_form_automationsList form automationsGETReturn a list of automations of a form. The automations are returned sorted by creation date, with the most recent automations appearing first.

Country, 1 operation

list_countriesList countriesGETReturn a list of all available countries. The countries are returned sorted by ISO code alphabetically.

Customer address, 1 operation

get_customer_addressGet customer addressGETRetrieves a customer address object.

Customer group, 1 operation

list_customer_groupsList customer groupsGETReturns a list of customer groups of a customer.

Domain, 1 operation

list_form_domainsList form domainsGETReturn a list of domains of a form. The domains are returned sorted by creation date, with the most recent domains appearing first.

Form shipping method, 1 operation

get_form_shipping_methodGet form shipping methodGETRetrieves a form shipping method object.

Free shipping, 1 operation

set_return_order_free_shippingSet return order free shippingPATCHUpdates free-shipping for a return order object.

Mark as delivered, 1 operation

mark_shipment_deliveredMark shipment deliveredPATCHSets a new status `delivered` and updates the `delivered_at`. Optionally, you can update the store location for return in store shipments.

Quantity, 1 operation

update_return_order_item_quantityUpdate return order item quantityPATCHUpdates the received and back-in-stock quantities of a return order item (quantity itself is deprecated by the vendor).

Reject, 1 operation

reject_return_orderReject return orderPOSTRejects a return order and returns it with its new state.

Return order item, 1 operation

get_return_order_itemGet return order itemGETRetrieves a return order item object.

Return rule, 1 operation

list_form_return_rulesList form return rulesGETReturn a list of return rules of a form. The return rules are returned sorted by creation date, with the most recent return rules appearing first.

Shipping contract, 1 operation

get_shipping_contractGet shipping contractGETRetrieves a shipping contract object.

Shipping method, 1 operation

list_form_shipping_methodsList form shipping methodsGETReturn a list of shipping methods of a form. The shipping-methods are returned sorted by creation date, with the most recent shipping methods appearing first.

Store location, 1 operation

list_form_store_locationsList form store locationsGETReturn a list of store locations of a form. The store locations are returned sorted by creation date, with the most recent store locations appearing first.

Use Returnless from Claude Code, Cursor or Codex

Connect Returnless in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Returnless operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Returnless

Create your workspace
Sign up free. Nothing to install.
Connect Returnless once
Add your Returnless connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.