View as Markdown
Returnista icon

Returnista ACTION

Get Return Request

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
  • Action
  • Read only
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Returnista account once, then configure and run Get Return Request from your backend or agent.

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-get-return-request",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    returnista: { authProvisionId: "apn_xxxxxxx" },
    accountId: "Account ID",
    returnRequestId: "Return Request ID",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Get Return Request inputs
Property Type Description
accountId Account ID string
The unique identifier of your Returnista account. Find this in the Returnista dashboard under account settings.
Required
returnRequestId Return Request ID string
The ID of the return request. Use Get Return Requests to find IDs.
Required Dynamic

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
returnista-get-return-request
Version
0.0.3
App
Returnista
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes