View as Markdown
SureCart icon

SureCart ACTION

Update Return Request

Update an existing return request. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's SureCart account once, then configure and run Update 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: "surecart-update-return-request",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    surecart: { authProvisionId: "apn_xxxxxxx" },
    returnRequestId: "Return Request ID",
    order: "Order 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.

Update Return Request inputs
Property Type Description
returnRequestId Return Request ID string
The unique identifier of the return request. Use List Return Requests to retrieve a list of available return requests.
Required
order Order ID string
The unique identifier of the order. Use List Orders to retrieve a list of available orders.
Required
returnItems Return Items string
Updated return items. Each item requires line_item (UUID), quantity (integer, must not exceed fulfilled quantity), and return_reason (one of: color, defective, not_as_described, other, size_too_large, size_too_small, style, unknown, unwanted, wrong_item). Include note when reason is other. Example: [{"line_item":"li_abc123","quantity":1,"return_reason":"other","note":"Item arrived damaged"}]
Optional
metadata Metadata object
Updated key-value metadata. Example: { "source": "customer_portal" }
Optional

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
surecart-update-return-request
Version
0.0.3
App
SureCart
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes