View as Markdown
Printful (OAuth) icon

Printful (OAuth) ACTION

Create Order

Creates an order. See docs here
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Printful (OAuth) account once, then configure and run Create 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: "printful_oauth-create-order",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    printful_oauth: { authProvisionId: "apn_xxxxxxx" },
    externalId: "External ID",
    recipientName: "Recipient Name",
  },
})

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 Order inputs
Property Type Description
externalId External ID string
Order ID from the external system
Optional
recipientName Recipient Name string
The recipient full name
Required
recipientCompanyName Recipient Company Name string
The recipient company name
Optional
address1 Address 1 string
The address 1
Required
address2 Address 2 string
The address 2
Optional
city City string
The city
Required
stateCode State Code string
The state code. E.g. SC
Required
countryCode Country Code string
The country code. E.g. BR
Required
zip ZIP/Postal Code string
The ZIP/postal code. E.g. 89221525
Required
phone Phone string
The phone number
Optional
email Email string
The email
Optional
giftSubject Gift Subject string
Gift message title
Optional
giftMessage Gift Message string
Gift message text
Optional
items Items string
Array of items in the order. E.g. [ { "id": 1, "variant_id": 2, "quantity": 3, "price": "13.60", "retail_price": "9.90", "name": "Beauty Poster", "product": { "product_id": 301, "variant_id": 500, "name": "Red T-Shirt" } } ]
Required

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
printful_oauth-create-order
Version
0.0.2
App
Printful (OAuth)
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes