View as Markdown
Returnless icon

Returnless ACTION

Create Return Order

Create a return order. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Returnless account once, then configure and run Create Return Order 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: "returnless-create-return-order",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    returnless: { authProvisionId: "apn_xxxxxxx" },
    formId: "Form ID",
    locale: "Locale",
  },
})

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 Order inputs
Property Type Description
formId Form ID string
The ID of the form to use for the return order
Required Dynamic
locale Locale string
The locale of the form to use for the return order
Required Dynamic
input Input string
The input for the order. This could be an email address or postalcode or something else.
Required
orderId Order ID string
The ID of the sales order to use for the return order
Required Dynamic
customerHouseNumber Customer House Number string
The house number of the customer
Required
customerStreet Customer Street string
The street of the customer
Required
customerPostalCode Customer Postal Code string
The postal code of the customer
Required
customerCity Customer City string
The city of the customer
Required
customerCountryId Country ID string
The ID of the country to use for the return order
Required Dynamic
itemIds Item IDs string[]
The IDs of the items in the sales order to return
Required Dynamic
metadata Metadata object
Metadata key/value pairs to add to the return order
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
returnless-create-return-order
Version
0.0.4
App
Returnless
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes