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.
- Tools
- 28
- What they doRead · write · destructive
- 18 · 7 · 318 read7 write3 destructive
- Users sign in with
- Access token
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Printful connection
In AgentKit > Connections, create a Printful connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts 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.actionsconst connector = 'printful'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'printful_catalog_products_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_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.actionsconnection_name = "printful"identifier = "user_123"# Generate an authorization link for the userlink_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 callresult = actions.execute_tool(tool_input={},tool_name="printful_catalog_products_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Printful credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolprintful_catalog_product_getGet one catalog product with all its variants.Read-onlyGet Catalog Product
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.
Inputs
idintegerrequired- ID of the catalog product. Example: 71
printful_catalog_product_size_guide_getGet the size guide tables for a catalog product.Read-onlyGet Product Size Guide
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.
Inputs
idintegerrequired- ID of the catalog product. Example: 71
unitstring- Comma-separated units for the size tables: inches, cm, or inches,cm. Defaults by locale. Example: inches,cm
printful_catalog_products_listList products in the Printful catalog (blank products you can print on), optionally by category.Read-onlyList Catalog Products
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.
Inputs
category_idstring- Comma-separated catalog category IDs to filter by (see printful_categories_list). Example: 24,32
printful_catalog_variant_getGet one catalog variant and its product.Read-onlyGet Catalog Variant
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.
Inputs
idintegerrequired- ID of the catalog variant. Example: 4012
printful_categories_listList all catalog categories.Read-onlyList Catalog Categories
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.
Inputs
This tool takes no inputs.
printful_countries_listList the countries and states Printful ships to, with their codes.Read-onlyList Countries
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.
Inputs
This tool takes no inputs.
printful_file_getGet one File Library file.Read-onlyGet File
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.
Inputs
idintegerrequired- ID of the file. Example: 10
store_idstring- 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
printful_order_costs_estimateCalculate the Printful and retail costs of an order without creating it.Read-onlyEstimate Order Costs
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.
Inputs
itemsarrayrequired- 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"}]}]
recipientobjectrequired- 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_costsobject- 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"}
shippingstring- Shipping method ID from printful_shipping_rates_calculate. Defaults to STANDARD. Example: STANDARD
store_idstring- 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
printful_order_getGet one order by Printful ID or @external_id.Read-onlyGet Order
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.
Inputs
idstringrequired- ID of the order, or your external ID prefixed with @. Example: 13 or @988123
store_idstring- 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
printful_orders_listList the store's orders, newest first, optionally by status.Read-onlyList Orders
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.
Inputs
limitinteger- Results per page, up to 100 (default 20). Example: 20
offsetinteger- Number of results to skip, for paging. Example: 20
statusstring- Filter by status: draft, failed, inreview, pending, canceled, onhold, inprocess, partial or fulfilled. Example: draftone of
draftfailedinreviewpendingcanceledonholdinprocesspartialfulfilled store_idstring- 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
printful_shipping_rates_calculateGet the available shipping methods and prices for items to a recipient address.Read-onlyCalculate Shipping Rates
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.
Inputs
itemsarrayrequired- 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}]
recipientobjectrequired- 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"}
currencystring- Three-letter currency to convert rates to; defaults to the store currency. Example: USD
localestring- Language of rate names: en_US (default) or es_ES. Example: en_USone of
en_USes_ES store_idstring- 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
printful_statistics_getGet store sales, costs and profit statistics for a date range.Read-onlyGet Statistics
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.
Inputs
date_fromstringrequired- Start date (YYYY-MM-DD). Example: 2026-10-01
date_tostringrequired- End date (YYYY-MM-DD). Example: 2026-10-31
report_typesstringrequired- 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
currencystring- Three-letter currency, or display_currency for the account's display currency. Example: USD
store_idstring- 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
printful_store_getGet basic information about one store.Read-onlyGet Store
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.
Inputs
idintegerrequired- ID of the store. Example: 1234567
printful_stores_listList the stores the token can access.Read-onlyList Stores
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.
Inputs
This tool takes no inputs.
printful_sync_product_getGet one store product with all its sync variants.Read-onlyGet Store Product
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.
Inputs
idstringrequired- ID of the sync product, or your external ID prefixed with @. Example: 362334569 or @my-product-1
store_idstring- 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
printful_sync_products_listList the store's products (sync products) for Manual Order / API stores, optionally by status or category.Read-onlyList Store Products
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.
Inputs
category_idstring- Comma-separated catalog category IDs. Example: 24
statusstring- Filter: all, synced, unsynced, ignored, imported, discontinued or out_of_stock. Example: syncedone of
allsyncedunsyncedignoredimporteddiscontinuedout_of_stock store_idstring- 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
printful_sync_variant_getGet one store variant with its product.Read-onlyGet Store Variant
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.
Inputs
idstringrequired- ID of the sync variant, or your external ID prefixed with @. Example: 1234567890 or @my-variant-1
store_idstring- 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
printful_token_scopes_getList the scopes granted to the current token.Read-onlyGet Token Scopes
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.
Inputs
This tool takes no inputs.
printful_file_addAdd a print file or image to the File Library from a public URL; Printful downloads it in the background.WriteAdd File
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.
Inputs
urlstringrequired- Public URL Printful downloads the file from (PNG, JPG or PDF). Example: https://www.example.com/files/tshirts/example.png
filenamestring- File name to store. Example: shirt1.png
optionsarray- Extra file options as [{"id": ..., "value": ...}]. Example: [{"id": "template_type", "value": "native"}]
store_idstring- 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
typestring- Role of the file, such as default (front print), back, preview or label_outside. Example: default
visibleboolean- Show the file in the File Library (default true). Example: true
printful_order_confirmSubmit a draft order for fulfillment; this charges the account's billing method.WriteConfirm Order
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.
Inputs
idstringrequired- ID of the draft order to confirm, or your external ID prefixed with @. Example: 13 or @988123
store_idstring- 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
printful_order_createCreate an order.WriteCreate Order
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.
Inputs
itemsarrayrequired- 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"}]}]
recipientobjectrequired- 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"}
confirmboolean- true to submit the order for fulfillment right away (charges the account). Leave empty for a draft. Example: false
external_idstring- Your order ID (unique per store). Example: 4235234213
giftobject- Gift message with subject and message. Example: {"subject": "To John", "message": "Have a nice day"}
packing_slipobject- Custom packing slip: email, phone, message, logo_url, store_name, custom_order_id. Example: {"email": "support@example.com", "message": "Thanks!"}
retail_costsobject- 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"}
shippingstring- Shipping method ID from printful_shipping_rates_calculate. Defaults to STANDARD. Example: STANDARD
store_idstring- 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_existingboolean- true to update an existing order with the same external_id instead of failing. Example: false
printful_order_updateReplace the details of a draft or failed order (recipient and items are required).WriteUpdate Order
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.
- Idempotent
Inputs
idstringrequired- ID of the order to update, or your external ID prefixed with @. Example: 13 or @988123
itemsarrayrequired- 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"}]}]
recipientobjectrequired- 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"}
confirmboolean- true to also submit the order for fulfillment (charges the account). Example: false
external_idstring- Your order ID (unique per store). Example: 4235234213
giftobject- Gift message with subject and message. Example: {"subject": "To John", "message": "Have a nice day"}
packing_slipobject- Custom packing slip: email, phone, message, logo_url, store_name, custom_order_id. Example: {"email": "support@example.com", "message": "Thanks!"}
retail_costsobject- 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"}
shippingstring- Shipping method ID from printful_shipping_rates_calculate. Defaults to STANDARD. Example: STANDARD
store_idstring- 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
printful_sync_product_createCreate a product in a Manual Order / API store from catalog variants and print files.WriteCreate Store Product
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.
Inputs
sync_productobjectrequired- 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_variantsarrayrequired- 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_idstring- 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
printful_sync_product_updateChange a store product and its variants; variants you include are created or updated, and variants you leave out of sync_variants are deleted.WriteUpdate Store Product
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.
- Idempotent
Inputs
idstringrequired- ID of the sync product to update, or your external ID prefixed with @. Example: 362334569 or @my-product-1
store_idstring- 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_productobject- Product fields to change, such as name or thumbnail. Example: {"name": "Summer T-shirt"}
sync_variantsarray- 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"}]
printful_sync_variant_updateChange one store variant; only the fields you pass change, but files and options replace the current lists.WriteUpdate Store Variant
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.
- Idempotent
Inputs
idstringrequired- ID of the sync variant to update, or your external ID prefixed with @. Example: 1234567890 or @my-variant-1
external_idstring- Your external variant ID. Example: 12312414
filesarray- Print files, replacing the current ones. Example: [{"url": "https://www.example.com/files/tshirts/example.png"}]
is_ignoredboolean- true to ignore this variant. Example: false
optionsarray- Product options as [{"id": ..., "value": ...}]. Example: [{"id": "embroidery_type", "value": "flat"}]
retail_pricestring- Retail price, as a string. Example: 29.99
skustring- SKU. Example: TSHIRT-WHITE-M
store_idstring- 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_idinteger- Catalog variant ID to link this variant to. Example: 4011
printful_order_cancelCancel an order that is a draft, failed, pending or on hold; orders in production cannot be cancelled.DestructiveCancel Order
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.
- Idempotent
Inputs
idstringrequired- ID of the order to cancel, or your external ID prefixed with @. Example: 13 or @988123
store_idstring- 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
printful_sync_product_deleteDelete a store product and all its variants.DestructiveDelete Store Product
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.
- Idempotent
Inputs
idstringrequired- ID of the sync product to delete, or your external ID prefixed with @. Example: 362334569 or @my-product-1
store_idstring- 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
printful_sync_variant_deleteDelete one store variant.DestructiveDelete Store Variant
Delete one store variant. Returns result with the deleted variant. Use printful_sync_variant_delete to drop a size or color from a product.
- Idempotent
Inputs
idstringrequired- ID of the sync variant to delete, or your external ID prefixed with @. Example: 1234567890 or @my-variant-1
store_idstring- 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
No tools match.