> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Printful

The Printful connector lets your AI agent act in each user's Printful account. Each user connects their own Printful access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 28 tools.

**Authentication:** Bearer Token
**Categories:** Automation, Design
**Tools:** 28: 18 read, 7 write, 3 destructive
**Users sign in with:** Access token
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=PRINTFUL)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Printful connection

   In **AgentKit > Connections**, create a Printful connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'printful'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Printful:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'printful_catalog_products_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "printful"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Printful:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="printful_catalog_products_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Printful credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'printful_catalog_product_get',
  toolInput: {
    id: 71,
  },
  connector: 'printful',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="printful_catalog_product_get",
    tool_input={
        "id": 71,
    },
    connection_name="printful",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `printful_catalog_product_get`

Get Catalog Product · Read-only

Get one catalog product with all its variants.
Returns result.product (title, brand, techniques, files and options) and result.variants[] with id, size, color, price and in_stock.
Use printful_catalog_product_get to find variant IDs for orders and sync products.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`integer`, required): ID of the catalog product. Example: 71

Example input: `{"id":71}`

### `printful_catalog_product_size_guide_get`

Get Product Size Guide · Read-only

Get the size guide tables for a catalog product.
Returns result with available_sizes and size_tables (measurements per size in inches or cm).
Use printful_catalog_product_size_guide_get to answer sizing questions.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`integer`, required): ID of the catalog product. Example: 71
- `unit` (`string`, optional): Comma-separated units for the size tables: inches, cm, or inches,cm. Defaults by locale. Example: inches,cm

Example input: `{"id":71}`

### `printful_catalog_products_list`

List Catalog Products · Read-only

List products in the Printful catalog (blank products you can print on), optionally by category.
Returns result[] with id, type, title, brand, model, image, variant_count and techniques.
Use printful_catalog_products_list to browse what Printful can make. Use printful_catalog_product_get for its variants.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `category_id` (`string`, optional): Comma-separated catalog category IDs to filter by (see printful_categories_list). Example: 24,32

Example input: `{}`

### `printful_catalog_variant_get`

Get Catalog Variant · Read-only

Get one catalog variant and its product.
Returns result.variant (size, color, price, in_stock, availability by region) and result.product.
Use printful_catalog_variant_get to check a variant's price and stock.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`integer`, required): ID of the catalog variant. Example: 4012

Example input: `{"id":4012}`

### `printful_categories_list`

List Catalog Categories · Read-only

List all catalog categories.
Returns result.categories[] with id, parent_id, title, image_url and catalog_position.
Use printful_categories_list to get category IDs for printful_catalog_products_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `printful_countries_list`

List Countries · Read-only

List the countries and states Printful ships to, with their codes.
Returns result[] with code, name and states[] (code, name).
Use printful_countries_list to get valid country_code and state_code values for recipients.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `printful_file_get`

Get File · Read-only

Get one File Library file.
Returns status (ok, waiting or failed), url, filename, mime_type, size, width, height, dpi, thumbnail_url and preview_url.
Use printful_file_get after printful_file_add to wait until the file is processed.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`integer`, required): ID of the file. Example: 10
- `store_id` (`string`, optional): Printful store ID, sent as the X-PF-Store-Id header. Needed only with an account-level token; store-level tokens already belong to one store. Get IDs from printful_stores_list. Example: 1234567

Example input: `{"id":10}`

### `printful_order_costs_estimate`

Estimate Order Costs · Read-only

Calculate the Printful and retail costs of an order without creating it.
Returns result.costs (subtotal, discount, shipping, digitization, tax, vat, total) and result.retail_costs.
Use printful_order_costs_estimate to quote an order. Use printful_order_create to place it.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `items` (`array`, required): Order items. Each identifies a product by sync_variant_id, external_variant_id, warehouse_product_variant_id, or a catalog variant_id with files (print files as [{"url": ...}]); add quantity, retail_price, name and options as needed. Example: [{"variant_id": 4012, "quantity": 1, "files": [{"url": "https://www.example.com/files/tshirts/example.png"}]}]
- `recipient` (`object`, required): Recipient address: name, address1, city, state_code (required for US, CA and AU), country_code, zip, and optionally company, address2, phone, email, tax_number. Example: {"name": "John Smith", "address1": "19749 Dearborn St", "city": "Chatsworth", "state_code": "CA", "country_code": "US", "zip": "91311", "email": "john@example.com"}
- `retail_costs` (`object`, optional): Retail costs to show on the packing slip, such as currency, subtotal, discount, shipping and tax. Example: {"currency": "USD", "subtotal": "10.00", "shipping": "5.00"}
- `shipping` (`string`, optional): Shipping method ID from printful_shipping_rates_calculate. Defaults to STANDARD. Example: STANDARD
- `store_id` (`string`, optional): Printful store ID, sent as the X-PF-Store-Id header. Needed only with an account-level token; store-level tokens already belong to one store. Get IDs from printful_stores_list. Example: 1234567

Example input: `{"items":[{"variant_id":"4012","quantity":1}],"recipient":{"name":"John Smith","address1":"19749 Dearborn St","city":"Chatsworth","state_code":"CA","country_code":"US","zip":"91311","email":"john@example.com"}}`

### `printful_order_get`

Get Order · Read-only

Get one order by Printful ID or @external_id.
Returns status, recipient, items, costs, retail_costs and shipments with tracking numbers.
Use printful_order_get to check fulfillment and tracking.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): ID of the order, or your external ID prefixed with @. Example: 13 or @988123
- `store_id` (`string`, optional): Printful store ID, sent as the X-PF-Store-Id header. Needed only with an account-level token; store-level tokens already belong to one store. Get IDs from printful_stores_list. Example: 1234567

Example input: `{"id":"<id>"}`

### `printful_orders_list`

List Orders · Read-only

List the store's orders, newest first, optionally by status.
Returns result[] with id, external_id, status, shipping, recipient, items, costs and created, plus paging.
Use printful_orders_list to find orders. Use printful_order_get for one order.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Results per page, up to 100 (default 20). Example: 20
- `offset` (`integer`, optional): Number of results to skip, for paging. Example: 20
- `status` (`string`, optional): Filter by status: draft, failed, inreview, pending, canceled, onhold, inprocess, partial or fulfilled. Example: draft. One of: `draft`, `failed`, `inreview`, `pending`, `canceled`, `onhold`, `inprocess`, `partial`, `fulfilled`.
- `store_id` (`string`, optional): Printful store ID, sent as the X-PF-Store-Id header. Needed only with an account-level token; store-level tokens already belong to one store. Get IDs from printful_stores_list. Example: 1234567

Example input: `{}`

### `printful_shipping_rates_calculate`

Calculate Shipping Rates · Read-only

Get the available shipping methods and prices for items to a recipient address.
Returns result[] with id (use as the order's shipping), name, rate, currency and delivery day estimates.
Use printful_shipping_rates_calculate to choose a shipping method before printful_order_create.

Read only: yes. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `items` (`array`, required): Items to ship; each needs quantity and one of variant_id, external_variant_id or warehouse_product_variant_id, plus optional value. Example: [{"variant_id": "4012", "quantity": 1}]
- `recipient` (`object`, required): Destination: country_code (required), state_code (for US, CA and AU), and optionally city, zip, address1, address2, phone. Example: {"address1": "19749 Dearborn St", "city": "Chatsworth", "country_code": "US", "state_code": "CA", "zip": "91311"}
- `currency` (`string`, optional): Three-letter currency to convert rates to; defaults to the store currency. Example: USD
- `locale` (`string`, optional): Language of rate names: en_US (default) or es_ES. Example: en_US. One of: `en_US`, `es_ES`.
- `store_id` (`string`, optional): Printful store ID, sent as the X-PF-Store-Id header. Needed only with an account-level token; store-level tokens already belong to one store. Get IDs from printful_stores_list. Example: 1234567

Example input: `{"items":[{"variant_id":"4012","quantity":1}],"recipient":{"address1":"19749 Dearborn St","city":"Chatsworth","country_code":"US","state_code":"CA","zip":"91311"}}`

### `printful_statistics_get`

Get Statistics · Read-only

Get store sales, costs and profit statistics for a date range.
Returns result with store_id, currency and one object per requested report type (for example sales_and_costs, profit, average_fulfillment_time, printful_costs, total_paid_orders, costs_by_amount, costs_by_product, costs_by_variant, sales_and_costs_summary).
Use printful_statistics_get for reporting.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `date_from` (`string`, required): Start date (YYYY-MM-DD). Example: 2026-10-01
- `date_to` (`string`, required): End date (YYYY-MM-DD). Example: 2026-10-31
- `report_types` (`string`, required): Comma-separated report types, such as sales_and_costs, sales_and_costs_summary, printful_costs, profit, total_paid_orders, costs_by_amount, costs_by_product, costs_by_variant, average_fulfillment_time. Example: sales_and_costs,profit
- `currency` (`string`, optional): Three-letter currency, or display_currency for the account's display currency. Example: USD
- `store_id` (`string`, optional): Printful store ID, sent as the X-PF-Store-Id header. Needed only with an account-level token; store-level tokens already belong to one store. Get IDs from printful_stores_list. Example: 1234567

Example input: `{"date_from":"<date_from>","date_to":"<date_to>","report_types":"<report_types>"}`

### `printful_store_get`

Get Store · Read-only

Get basic information about one store. Needs an account-level token.
Returns result with id, name and type.
Use printful_store_get for a known store ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`integer`, required): ID of the store. Example: 1234567

Example input: `{"id":1234567}`

### `printful_stores_list`

List Stores · Read-only

List the stores the token can access. Needs an account-level token; store-level tokens get 403.
Returns result[] with id, name and type.
Use printful_stores_list to find the store_id for other tools when you use an account-level token.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `printful_sync_product_get`

Get Store Product · Read-only

Get one store product with all its sync variants.
Returns result.sync_product and result.sync_variants[] with id, variant_id, retail_price, sku, files and options.
Use printful_sync_product_get to get sync_variant_id values for orders.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): ID of the sync product, or your external ID prefixed with @. Example: 362334569 or @my-product-1
- `store_id` (`string`, optional): Printful store ID, sent as the X-PF-Store-Id header. Needed only with an account-level token; store-level tokens already belong to one store. Get IDs from printful_stores_list. Example: 1234567

Example input: `{"id":"<id>"}`

### `printful_sync_products_list`

List Store Products · Read-only

List the store's products (sync products) for Manual Order / API stores, optionally by status or category.
Returns result[] with id, external_id, name, variants count, synced count and thumbnail_url, plus paging.
Use printful_sync_products_list to find products to order. Use printful_sync_product_get for their variants.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `category_id` (`string`, optional): Comma-separated catalog category IDs. Example: 24
- `status` (`string`, optional): Filter: all, synced, unsynced, ignored, imported, discontinued or out_of_stock. Example: synced. One of: `all`, `synced`, `unsynced`, `ignored`, `imported`, `discontinued`, `out_of_stock`.
- `store_id` (`string`, optional): Printful store ID, sent as the X-PF-Store-Id header. Needed only with an account-level token; store-level tokens already belong to one store. Get IDs from printful_stores_list. Example: 1234567

Example input: `{}`

### `printful_sync_variant_get`

Get Store Variant · Read-only

Get one store variant with its product.
Returns result.sync_variant (variant_id, retail_price, sku, files, options, availability_status) and result.sync_product.
Use printful_sync_variant_get for a single variant.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): ID of the sync variant, or your external ID prefixed with @. Example: 1234567890 or @my-variant-1
- `store_id` (`string`, optional): Printful store ID, sent as the X-PF-Store-Id header. Needed only with an account-level token; store-level tokens already belong to one store. Get IDs from printful_stores_list. Example: 1234567

Example input: `{"id":"<id>"}`

### `printful_token_scopes_get`

Get Token Scopes · Read-only

List the scopes granted to the current token.
Returns result.scopes[] with each scope's name and value, such as orders or sync_products/read.
Use printful_token_scopes_get to check what the token may do before calling write tools.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `printful_file_add`

Add File · Write

Add a print file or image to the File Library from a public URL; Printful downloads it in the background.
Returns result with the file id, status (waiting until processed), filename, preview_url and dimensions.
Use printful_file_add to upload artwork once and reuse its id in orders and products. Use printful_file_get to check processing.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `url` (`string`, required): Public URL Printful downloads the file from (PNG, JPG or PDF). Example: https://www.example.com/files/tshirts/example.png
- `filename` (`string`, optional): File name to store. Example: shirt1.png
- `options` (`array`, optional): Extra file options as [{"id": ..., "value": ...}]. Example: [{"id": "template_type", "value": "native"}]
- `store_id` (`string`, optional): Printful store ID, sent as the X-PF-Store-Id header. Needed only with an account-level token; store-level tokens already belong to one store. Get IDs from printful_stores_list. Example: 1234567
- `type` (`string`, optional): Role of the file, such as default (front print), back, preview or label_outside. Example: default
- `visible` (`boolean`, optional): Show the file in the File Library (default true). Example: true

Example input: `{"url":"<url>"}`

### `printful_order_confirm`

Confirm Order · Write

Submit a draft order for fulfillment; this charges the account's billing method.
Returns the order with status pending.
Use printful_order_confirm after reviewing a draft from printful_order_create.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `id` (`string`, required): ID of the draft order to confirm, or your external ID prefixed with @. Example: 13 or @988123
- `store_id` (`string`, optional): Printful store ID, sent as the X-PF-Store-Id header. Needed only with an account-level token; store-level tokens already belong to one store. Get IDs from printful_stores_list. Example: 1234567

Example input: `{"id":"<id>"}`

### `printful_order_create`

Create Order · Write

Create an order. It is a draft (not charged) unless confirm is true, which submits it for fulfillment and charges the account.
Returns the order with id, status, costs (subtotal, shipping, tax, total) and items.
Use printful_order_create to place an order; leave confirm empty to review costs, then printful_order_confirm. Use printful_order_costs_estimate for costs without creating anything.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `items` (`array`, required): Order items. Each identifies a product by sync_variant_id, external_variant_id, warehouse_product_variant_id, or a catalog variant_id with files (print files as [{"url": ...}]); add quantity, retail_price, name and options as needed. Example: [{"variant_id": 4012, "quantity": 1, "files": [{"url": "https://www.example.com/files/tshirts/example.png"}]}]
- `recipient` (`object`, required): Recipient address: name, address1, city, state_code (required for US, CA and AU), country_code, zip, and optionally company, address2, phone, email, tax_number. Example: {"name": "John Smith", "address1": "19749 Dearborn St", "city": "Chatsworth", "state_code": "CA", "country_code": "US", "zip": "91311", "email": "john@example.com"}
- `confirm` (`boolean`, optional): true to submit the order for fulfillment right away (charges the account). Leave empty for a draft. Example: false
- `external_id` (`string`, optional): Your order ID (unique per store). Example: 4235234213
- `gift` (`object`, optional): Gift message with subject and message. Example: {"subject": "To John", "message": "Have a nice day"}
- `packing_slip` (`object`, optional): Custom packing slip: email, phone, message, logo_url, store_name, custom_order_id. Example: {"email": "support@example.com", "message": "Thanks!"}
- `retail_costs` (`object`, optional): Retail costs to show on the packing slip, such as currency, subtotal, discount, shipping and tax. Example: {"currency": "USD", "subtotal": "10.00", "shipping": "5.00"}
- `shipping` (`string`, optional): Shipping method ID from printful_shipping_rates_calculate. Defaults to STANDARD. Example: STANDARD
- `store_id` (`string`, optional): Printful store ID, sent as the X-PF-Store-Id header. Needed only with an account-level token; store-level tokens already belong to one store. Get IDs from printful_stores_list. Example: 1234567
- `update_existing` (`boolean`, optional): true to update an existing order with the same external_id instead of failing. Example: false

Example input: `{"items":[{"variant_id":"4012","quantity":1}],"recipient":{"name":"John Smith","address1":"19749 Dearborn St","city":"Chatsworth","state_code":"CA","country_code":"US","zip":"91311","email":"john@example.com"}}`

### `printful_order_update`

Update Order · Write

Replace the details of a draft or failed order (recipient and items are required).
Returns the updated order with recalculated costs.
Use printful_order_update to fix a draft before confirming. Orders already in fulfillment cannot be changed.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): ID of the order to update, or your external ID prefixed with @. Example: 13 or @988123
- `items` (`array`, required): Order items. Each identifies a product by sync_variant_id, external_variant_id, warehouse_product_variant_id, or a catalog variant_id with files (print files as [{"url": ...}]); add quantity, retail_price, name and options as needed. Example: [{"variant_id": 4012, "quantity": 1, "files": [{"url": "https://www.example.com/files/tshirts/example.png"}]}]
- `recipient` (`object`, required): Recipient address: name, address1, city, state_code (required for US, CA and AU), country_code, zip, and optionally company, address2, phone, email, tax_number. Example: {"name": "John Smith", "address1": "19749 Dearborn St", "city": "Chatsworth", "state_code": "CA", "country_code": "US", "zip": "91311", "email": "john@example.com"}
- `confirm` (`boolean`, optional): true to also submit the order for fulfillment (charges the account). Example: false
- `external_id` (`string`, optional): Your order ID (unique per store). Example: 4235234213
- `gift` (`object`, optional): Gift message with subject and message. Example: {"subject": "To John", "message": "Have a nice day"}
- `packing_slip` (`object`, optional): Custom packing slip: email, phone, message, logo_url, store_name, custom_order_id. Example: {"email": "support@example.com", "message": "Thanks!"}
- `retail_costs` (`object`, optional): Retail costs to show on the packing slip, such as currency, subtotal, discount, shipping and tax. Example: {"currency": "USD", "subtotal": "10.00", "shipping": "5.00"}
- `shipping` (`string`, optional): Shipping method ID from printful_shipping_rates_calculate. Defaults to STANDARD. Example: STANDARD
- `store_id` (`string`, optional): Printful store ID, sent as the X-PF-Store-Id header. Needed only with an account-level token; store-level tokens already belong to one store. Get IDs from printful_stores_list. Example: 1234567

Example input: `{"id":"<id>","items":[{"variant_id":"4012","quantity":1}],"recipient":{"name":"John Smith","address1":"19749 Dearborn St","city":"Chatsworth","state_code":"CA","country_code":"US","zip":"91311","email":"john@example.com"}}`

### `printful_sync_product_create`

Create Store Product · Write

Create a product in a Manual Order / API store from catalog variants and print files.
Returns result with the new id, external_id, name and variant counts.
Use printful_sync_product_create to set up a product you can then order by sync_variant_id. Limited to 10 per minute.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `sync_product` (`object`, required): Product info: name (required), and optional external_id, thumbnail URL and is_ignored. Example: {"external_id": "4235234213", "name": "T-shirt", "thumbnail": "https://www.example.com/files/tshirts/example.png"}
- `sync_variants` (`array`, required): Variants; each needs variant_id (catalog variant) and files (print files as [{"url": ...}] or [{"id": ...}]); add retail_price, sku, external_id and options as needed. Example: [{"variant_id": 4011, "retail_price": "21.00", "files": [{"url": "https://www.example.com/files/tshirts/example.png"}]}]
- `store_id` (`string`, optional): Printful store ID, sent as the X-PF-Store-Id header. Needed only with an account-level token; store-level tokens already belong to one store. Get IDs from printful_stores_list. Example: 1234567

Example input: `{"sync_product":{"external_id":"4235234213","name":"T-shirt","thumbnail":"https://www.example.com/files/tshirts/example.png"},"sync_variants":[{"id":1234567890,"retail_price":"23.00"}]}`

### `printful_sync_product_update`

Update Store Product · Write

Change a store product and its variants; variants you include are created or updated, and variants you leave out of sync_variants are deleted.
Returns result with the product id and counts.
Use printful_sync_product_update to rename a product or replace its variants. Use printful_sync_variant_update to change one variant.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): ID of the sync product to update, or your external ID prefixed with @. Example: 362334569 or @my-product-1
- `store_id` (`string`, optional): Printful store ID, sent as the X-PF-Store-Id header. Needed only with an account-level token; store-level tokens already belong to one store. Get IDs from printful_stores_list. Example: 1234567
- `sync_product` (`object`, optional): Product fields to change, such as name or thumbnail. Example: {"name": "Summer T-shirt"}
- `sync_variants` (`array`, optional): The full list of variants to keep; each existing one by id, new ones with variant_id and files. Omit to leave variants unchanged. Example: [{"id": 1234567890, "retail_price": "23.00"}]

Example input: `{"id":"<id>"}`

### `printful_sync_variant_update`

Update Store Variant · Write

Change one store variant; only the fields you pass change, but files and options replace the current lists.
Returns result with the updated sync variant.
Use printful_sync_variant_update to change a price, SKU or print file.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): ID of the sync variant to update, or your external ID prefixed with @. Example: 1234567890 or @my-variant-1
- `external_id` (`string`, optional): Your external variant ID. Example: 12312414
- `files` (`array`, optional): Print files, replacing the current ones. Example: [{"url": "https://www.example.com/files/tshirts/example.png"}]
- `is_ignored` (`boolean`, optional): true to ignore this variant. Example: false
- `options` (`array`, optional): Product options as [{"id": ..., "value": ...}]. Example: [{"id": "embroidery_type", "value": "flat"}]
- `retail_price` (`string`, optional): Retail price, as a string. Example: 29.99
- `sku` (`string`, optional): SKU. Example: TSHIRT-WHITE-M
- `store_id` (`string`, optional): Printful store ID, sent as the X-PF-Store-Id header. Needed only with an account-level token; store-level tokens already belong to one store. Get IDs from printful_stores_list. Example: 1234567
- `variant_id` (`integer`, optional): Catalog variant ID to link this variant to. Example: 4011

Example input: `{"id":"<id>"}`

### `printful_order_cancel`

Cancel Order · Destructive

Cancel an order that is a draft, failed, pending or on hold; orders in production cannot be cancelled.
Returns the order with status canceled.
Use printful_order_cancel to stop an order before fulfillment.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): ID of the order to cancel, or your external ID prefixed with @. Example: 13 or @988123
- `store_id` (`string`, optional): Printful store ID, sent as the X-PF-Store-Id header. Needed only with an account-level token; store-level tokens already belong to one store. Get IDs from printful_stores_list. Example: 1234567

Example input: `{"id":"<id>"}`

### `printful_sync_product_delete`

Delete Store Product · Destructive

Delete a store product and all its variants.
Returns result with the deleted product info.
Use printful_sync_product_delete to remove a product you no longer sell.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): ID of the sync product to delete, or your external ID prefixed with @. Example: 362334569 or @my-product-1
- `store_id` (`string`, optional): Printful store ID, sent as the X-PF-Store-Id header. Needed only with an account-level token; store-level tokens already belong to one store. Get IDs from printful_stores_list. Example: 1234567

Example input: `{"id":"<id>"}`

### `printful_sync_variant_delete`

Delete Store Variant · Destructive

Delete one store variant.
Returns result with the deleted variant.
Use printful_sync_variant_delete to drop a size or color from a product.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): ID of the sync variant to delete, or your external ID prefixed with @. Example: 1234567890 or @my-variant-1
- `store_id` (`string`, optional): Printful store ID, sent as the X-PF-Store-Id header. Needed only with an account-level token; store-level tokens already belong to one store. Get IDs from printful_stores_list. Example: 1234567

Example input: `{"id":"<id>"}`

## Related

Other Automation connectors ([all 91](/agentkit/connectors/?category=automation)):

- [Mailchimp](/agentkit/connectors/mailchimp/): Scalekit connector, OAuth, 73 tools
- [Twilio](/agentkit/connectors/twilio/): Scalekit connector, Username and password, 61 tools
- [Stripe](/agentkit/connectors/stripe/): Scalekit connector, Access token, 178 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
