View as Markdown
SureCart icon

SureCart ACTION

Create Return Request

Create a new return request for an order. 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 Create 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-create-return-request",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    surecart: { authProvisionId: "apn_xxxxxxx" },
    order: "Order ID",
    returnItems: "Return Items",
  },
})

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.

Create Return Request inputs
Property Type Description
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
Items to return. Each item requires line_item (UUID), quantity (integer), and return_reason_id (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_id": "defective" }]
Required
metadata Metadata object
Additional 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-create-return-request
Version
0.0.3
App
SureCart
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes