# Returnista — Pipedream Connect

> Returns management platform for e-commerce retailers

- API slug: `returnista` (use in MCP headers and tool keys)
- Auth: API key (Pipedream-managed)
- Categories: Commerce
- Website: https://www.returnista.nl/en
- This page (HTML): https://pipedream.com/apps/returnista
- Tools: 15 actions · 7 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: returnista`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "returnista",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Create Draft Return Order:
const result = await mcp.callTool({
  name: "returnista-create-draft-return-order",
  arguments: {
    consumerId: "Consumer ID",
    purchaseId: "Purchase ID",
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a Returnista endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://core.returnista.com/api/v0/return-reasons

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9jb3JlLnJldHVybmlzdGEuY29tL2FwaS92MC9yZXR1cm4tcmVhc29ucw?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "returnista-create-draft-return-order",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    returnista: { authProvisionId: "apn_xxxxxxx" },
    consumerId: "Consumer ID",
    purchaseId: "Purchase ID",
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (15)

### `returnista-create-draft-return-order` — Create Draft Return Order (Write)

Creates a new draft return order for a consumer. Draft return orders are pending merchant review before being accepted or rejected. Use Process Draft Return Order to accept or reject the created draft. See the documentation

Full schema: https://pipedream.com/apps/returnista/actions/create-draft-return-order.md

### `returnista-create-return-location` — Create Return Location (Write)

Creates a new return location (warehouse or depot address) for an account. Required: accountId, name, companyName, phoneNumber, street, houseNumber, city, postalCode, countryCode (ISO 3166-1 alpha-2, e.g. NL, DE, GB, US). Optional: suffix, stateProvinceCode, attention, contactName. To update a…

Full schema: https://pipedream.com/apps/returnista/actions/create-return-location.md

### `returnista-get-consumer-purchases` — Get Consumer Purchases (Read-only)

Gets the purchase history for a consumer by their consumer ID. Useful for support workflows to understand what a consumer has purchased before they initiated a return. To find a consumer ID, use Get Return Orders with expand: ["consumer"] on a related return order — the consumer object will include…

Full schema: https://pipedream.com/apps/returnista/actions/get-consumer-purchases.md

### `returnista-get-draft-return-orders` — Get Draft Return Orders (Read-only)

Gets a list of draft return orders for the given account. See the documentation

Full schema: https://pipedream.com/apps/returnista/actions/get-draft-return-orders.md

### `returnista-get-return-locations` — Get Return Locations (Read-only)

Gets a list of return locations for the given account. See the documentation

Full schema: https://pipedream.com/apps/returnista/actions/get-return-locations.md

### `returnista-get-return-order` — Get Return Order (Read-only)

Gets the full details of a single return order by ID. Use expand to inline related objects (consumer, shipments, returnRequests) in one call instead of making separate requests. To find a return order ID, use Get Return Orders first. To view the email communications for a return order, use Get…

Full schema: https://pipedream.com/apps/returnista/actions/get-return-order.md

### `returnista-get-return-order-emails` — Get Return Order Emails (Read-only)

Gets all email communications associated with a return order. Useful for support and audit workflows to see what emails were sent to the consumer during the return process. To find a return order ID, use Get Return Orders first. See the documentation

Full schema: https://pipedream.com/apps/returnista/actions/get-return-order-emails.md

### `returnista-get-return-orders` — Get Return Orders (Read-only)

Gets a list of return orders for the given account. See the documentation

Full schema: https://pipedream.com/apps/returnista/actions/get-return-orders.md

### `returnista-get-return-reasons` — Get Return Reasons (Read-only)

Gets a list of return reasons for the given account. See the documentation

Full schema: https://pipedream.com/apps/returnista/actions/get-return-reasons.md

### `returnista-get-return-request` — Get Return Request (Read-only)

Gets the full details of a single return request by ID. Return requests contain item-level information: purchase order number, return reason, requested resolution (refund, exchange, etc.). To find a return request ID, use Get Return Requests first. See the documentation

Full schema: https://pipedream.com/apps/returnista/actions/get-return-request.md

### `returnista-get-return-requests` — Get Return Requests (Read-only)

Gets a list of return requests for the given account. See the documentation

Full schema: https://pipedream.com/apps/returnista/actions/get-return-requests.md

### `returnista-list-shipping-products` — List Shipping Products (Read-only)

Returns all shipping product options available in Returnista, including carrier integrations, label types, and product codes. See the documentation

Full schema: https://pipedream.com/apps/returnista/actions/list-shipping-products.md

### `returnista-process-draft-return-order` — Process Draft Return Order (Write)

Accepts or rejects a draft return order. Draft return orders are created when a consumer initiates a return and are pending merchant review. Set action to accept to approve the return (this triggers shipment label creation) or reject to decline it. Use Get Return Orders with filter: "status:draft"…

Full schema: https://pipedream.com/apps/returnista/actions/process-draft-return-order.md

### `returnista-resend-confirmation-email` — Resend Confirmation Email (Write)

Resends the return confirmation email to the consumer for an existing return order. Use this when a consumer did not receive their original confirmation, when an email bounced, or to re-trigger a notification after a return order is updated. To look up a return order ID, use Get Return Orders or…

Full schema: https://pipedream.com/apps/returnista/actions/resend-confirmation-email.md

### `returnista-update-return-location` — Update Return Location (Write)

Updates an existing return location for an account. All fields are optional — provide only the ones you want to change. At least one field must be provided. To find the return location ID, use Get Return Locations. Use a two-letter ISO 3166-1 alpha-2 country code for countryCode (e.g., NL, DE, GB…

Full schema: https://pipedream.com/apps/returnista/actions/update-return-location.md

## Triggers (7)

### `returnista-return-order-completed-instant` — New Return Order Completed (Instant) (Instant)

Emit new event when a return order is completed. See the documentation

Full schema: https://pipedream.com/apps/returnista/triggers/return-order-completed-instant.md

### `returnista-return-order-confirmed-instant` — New Return Order Confirmed (Instant) (Instant)

Emit new event when a return order is confirmed. See the documentation

Full schema: https://pipedream.com/apps/returnista/triggers/return-order-confirmed-instant.md

### `returnista-new-return-order-created-instant` — New Return Order Created (Instant) (Instant)

Emit new event when a new return order is created. See the documentation

Full schema: https://pipedream.com/apps/returnista/triggers/new-return-order-created-instant.md

### `returnista-sales-order-approved-or-denied-instant` — New Sales Order Approved or Denied (Instant) (Instant)

Emit new event when a sales order is approved or denied. See the documentation

Full schema: https://pipedream.com/apps/returnista/triggers/sales-order-approved-or-denied-instant.md

### `returnista-new-shipment-label-created-instant` — New Shipment Label Created (Instant) (Instant)

Emit new event when a new shipment label is created. See the documentation

Full schema: https://pipedream.com/apps/returnista/triggers/new-shipment-label-created-instant.md

### `returnista-shipment-received-tracking-updates-instant` — New Shipment Received Tracking Updates (Instant) (Instant)

Emit new event when a shipment receives tracking updates. See the documentation

Full schema: https://pipedream.com/apps/returnista/triggers/shipment-received-tracking-updates-instant.md

### `returnista-tracking-update-delivered-instant` — New Tracking Update Delivered (Instant) (Instant)

Emit new event when a tracking update is received and the shipment status changes to delivered. See the documentation

Full schema: https://pipedream.com/apps/returnista/triggers/tracking-update-delivered-instant.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt