Integration

Returnista integration

Returnista is a returns management platform for online stores. List and read return orders, return requests and draft return orders, accept or reject drafts, approve, deny, reopen or process the resolution (refund, exchange, store credit) of return requests, read sales orders and their events, manage return locations, store shipping options and webhook subscriptions, read shipping contracts and shipping products, and read or update stores (brand, return policy, return reasons, returns portal). The shopper-facing portal routes, login routes, service user (API key) management, channel cloning and creating or editing shipping contracts (carrier credentials) are not exposed. Authentication is a non-expiring account API key from a Returnista service user, sent as a Bearer token, plus the account ID.

Connect Returnista How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

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

What you can do with Returnista

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.

Id, 10 operations

delete_shipping_contractDelete shipping contractDELETEDeletes a shipping contract (a carrier contract used to buy return labels) of the account.
delete_store_shipping_optionDelete store shipping optionDELETEDeletes a shipping option of a store.
get_return_orderGet return orderGETReturns one return order with its consumer, return requests, shipments, prices, fees and status.
get_return_reasonGet return reasonGETReturns one return reason: its key, description, details and whether it is a default.
get_shipping_contractGet shipping contractGETReturns one shipping contract of the account: description, type and applicable shipping product IDs.
get_shipping_productGet shipping productGETReturns one shipping product (a carrier service such as a drop-off label) with its code, label type and carrier.
get_storeGet storeGETReturns one store with its settings: return policy, brand, support info, store credit, return reasons and returns portal.
get_store_shipping_optionGet store shipping optionGETReturns one shipping option of a store: route, price, shipping product, contract and fees.
update_storeUpdate storePATCHUpdates a store's general settings (name, URL, languages, currency, status, default return location...); only the fields sent change.
update_store_shipping_optionUpdate store shipping optionPATCHUpdates a shipping option of a store; only the fields sent change.

Subscription id, 3 operations

delete_webhook_subscriptionDelete webhook subscriptionDELETEDeletes a webhook subscription of the account.
get_webhook_subscriptionGet webhook subscriptionGETReturns one webhook subscription: its URL, event name and description.
update_webhook_subscriptionUpdate webhook subscriptionPATCHUpdates a webhook subscription: URL, event name or description; only the fields sent change.

Approve, 2 operations

approve_resolutionApprove resolutionPUTApproves the open resolution of one return request so it can be processed. Returns the updated return request.
approve_resolutionsApprove resolutionsPUTApproves the open resolutions of several return requests of one store at once, so they can then be processed. Returns the updated return requests.

Deny, 2 operations

deny_resolutionDeny resolutionPUTDenies the open resolution of one return request with a reason code, so it is not processed. Returns the updated return request.
deny_resolutionsDeny resolutionsPUTDenies the open resolutions of several return requests of one store at once with one reason code, so they are not processed.

Email, 2 operations

list_return_order_emailsList return order emailsGETLists the emails sent to the consumer for one return order: subject, status, date and whether it was opened.
list_return_orders_emailsList return orders emailsGETLists the emails sent to consumers for one or several return orders: subject, status, date and whether opened.

Process, 2 operations

process_resolutionProcess resolutionPOSTAttempts to process a single Return Request. Only approved return requests can be processed.
process_resolutionsProcess resolutionsPOSTProcesses the approved resolutions of the given return requests of one store and returns the resolution transactions created; a failed one still answers 200, as a transaction in a failed state.

Reopen, 2 operations

reopen_resolutionReopen resolutionPUTReopens the resolution of one return request so it can again be approved or denied.
reopen_resolutionsReopen resolutionsPUTReopens the resolutions of several return requests of one store, so they can again be approved or denied.

Return location, 2 operations

create_return_locationCreate return locationPOSTCreates a return location (a warehouse address returns are shipped to) on the account and returns its id.
list_return_locationsList return locationsGETLists the return locations (warehouse addresses returns are shipped to) of the account.

Return reason, 2 operations

list_return_reasonsList return reasonsGETLists every return reason Returnista offers, to assign to a store with update_store_return_reasons.
update_store_return_reasonsUpdate store return reasonsPUTReplaces the list of return reasons a store offers to shoppers, with their order and comment settings.

Return request, 2 operations

get_return_requestGet return requestGETReturns one return request (one purchased unit to return): reason, product, resolution, prices and status; expand consumer or returnReason.
list_return_requestsList return requestsGETLists the return requests (one per purchased unit to return) of the account; filter by purchase order number or creation date.

Sales order, 2 operations

get_sales_orderGet sales orderGETReturns one sales order of a store by its order number, with its consumer, items and return requests.
list_sales_ordersList sales ordersGETLists the sales orders (the shop orders returns are made against) of the account.

Webhook subscription, 2 operations

create_webhook_subscriptionCreate webhook subscriptionPOSTSubscribes a URL to one Returnista event (return order created or completed, draft accepted, shipment tracking...). Returns the subscription id; the signing secret is not passed back.
list_webhook_subscriptionsList webhook subscriptionsGETLists the webhook subscriptions of the account with their URL, event name and description.

Accept, 1 operation

accept_draft_return_orderAccept draft return orderPUTAccepts a draft return order (a return the shopper requested that needs approval) and returns the draft with its new status.

Account id, 1 operation

get_accountGet accountGETReturns the connected Returnista account: name, email, status, slug, commissions and creation dates.

Brand, 1 operation

update_store_brandUpdate store brandPATCHUpdates the branding of a store's returns portal: logo and cover images, favicon, font and button colors.

Draft return order, 1 operation

list_draft_return_ordersList draft return ordersGETGets a list of draft return orders for the given account. Supports filtering, searching, sorting, and pagination.

Event, 1 operation

list_sales_order_eventsList sales order eventsGETLists the events recorded on one sales order of the account.

Execution id, 1 operation

get_automation_executionGet automation executionGETReturns one execution of a store automation: status, start and finish times and error message.

Reject, 1 operation

reject_draft_return_orderReject draft return orderPUTRejects a draft return order (a return the shopper requested that needs approval) and returns the draft with its new status.

Resend confirmation email, 1 operation

resend_return_order_confirmation_emailResend return order confirmation emailGETSends the confirmation email of a return order to the consumer again.

Resolution, 1 operation

update_resolutionUpdate resolutionPATCHUpdates a Return Request Resolution. Only the resolution type and restock location can be updated.

Resolution transaction, 1 operation

list_resolution_transactionsList resolution transactionsGETLists the resolution transactions (refunds, exchanges, store credit issued for return requests) of the account; filter by purchaseOrderNumber or returnRequestId.

Return location id, 1 operation

update_return_locationUpdate return locationPATCHUpdates a return location of the account (name, address, company, phone, contact); only the fields sent change.

Return order, 1 operation

list_return_ordersList return ordersGETLists the return orders of the account, 20 per page by default (at most 50), newest first; filter by order number, search, sort, and expand consumer, return requests or shipments.

Return policy, 1 operation

update_store_return_policyUpdate store return policyPATCHUpdates a store's return policy: return period, grace period, exchanges, store credit, fees and non-returnable categories.

Returns portal, 1 operation

update_store_returns_portalUpdate store returns portalPATCHUpdates the returns portal settings of a store (locales, logo, quantity selector, prices shown, redirect URL...).

Shipping contract, 1 operation

list_shipping_contractsList shipping contractsGETLists the shipping contracts (carrier contracts used for return labels) of the account.

Shipping option, 1 operation

create_store_shipping_optionCreate store shipping optionPOSTCreates a shipping option on a store: the route (sender and receiver countries), price, shipping product and fees offered to shoppers.

Shipping product, 1 operation

list_shipping_productsList shipping productsGETLists the shipping products (carrier services for return labels) Returnista supports.

Store, 1 operation

list_storesList storesGETLists the stores (web shops) of the account with their settings; a store ID is what the store tools take.

Support info, 1 operation

update_store_support_infoUpdate store support infoPATCHUpdates the support email address and support URL shown to shoppers of a store.

Use Returnista from Claude Code, Cursor or Codex

Connect Returnista in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Returnista 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 Returnista

Create your workspace
Sign up free. Nothing to install.
Connect Returnista once
Add your Returnista 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.