View as Markdown
Printful icon

Printful ACTION

Create Order

Creates a new order in your Printful account. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Printful 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-create-order",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    printful: { authProvisionId: "apn_xxxxxxx" },
    storeId: "Store ID",
    externalId: "External 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.

Create Order inputs
Property Type Description
storeId Store ID string
Select a store or provide s store ID to use for the request
Required Dynamic
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
taxNumber Tax Number string
TAX number (optional, but in case of Brazil country this field becomes required and will be used as CPF/CNPJ number)
Optional
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" }, "files": [{"url": "https://file.com/060b204a37f.png"}] } ]
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-create-order
Version
0.0.3
App
Printful
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes