Skip to main content
Printify logo
  • Category: ecommerce
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 25
  • Triggers: 0
  • Slug: PRINTIFY
  • Version: 20261101_00

Tools

Slug: PRINTIFY_ARCHIVE_UPLOADIrreversibly archive an image in the connected merchant’s Printify media library. This cannot be undone, removes it from normal media-library use, and may affect future product editing, but does not remove artwork already rendered into existing products. Use only after checking the exact image ID and explicitly confirming archival.

Input Parameters

string
required
Exact Printify uploaded image ID to archive.
boolean
required
Must be true to confirm archival. This confirmation is validated locally and not sent to Printify.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PRINTIFY_CALCULATE_ORDER_SHIPPINGCalculate available shipping-cost estimates for proposed line items and a destination. This is quote-only: it does not create an order, send anything to production, or charge the merchant, despite requiring orders.write. Returned amounts are estimates in integer minor currency units.

Input Parameters

integer
required
Printify shop used to price the proposed shipment.
object
required
Recipient and postal destination used only to calculate shipping quotes.
array
required
Proposed items in exactly one documented form per entry: existing product and variant, catalog blueprint configuration, or SKU.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PRINTIFY_CREATE_PRODUCTCreate a new product draft in a Printify shop. This changes merchant data but does not publish the product or submit an order. Validate blueprint, provider, variant, print-position, and uploaded image IDs before calling.

Input Parameters

string
required
Merchant-facing product title.
integer
required
Shop in which to create the draft product.
array
required
Non-empty list of variant IDs, prices, and enabled states.
string
Optional product description. Printify accepts HTML for compatible channels.
array
required
Non-empty list mapping variants to provider print positions and images.
integer
required
Blueprint ID selected from catalog discovery.
integer
required
Print provider ID verified as compatible with the blueprint.
string
Optional product safety and compliance information.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PRINTIFY_CREATE_WEBHOOKCreate a persistent webhook subscription for a Printify shop. Printify sends real event payloads to the HTTPS callback URL. An optional signing secret can be supplied for receiver-side X-Pfy-Signature verification.

Input Parameters

string
required
Public HTTPS callback URL ready to receive Printify POST requests.
string ("shop:disconnected" | "product:deleted" | "product:created" | "product:updated" | "product:publish:started" | "order:created" | "order:updated" | "order:sent-to-production" | "order:shipment:created" | "order:shipment:delivered")
required
Exact Printify event topic to deliver to the callback URL.
string
Optional sensitive HMAC secret used to verify X-Pfy-Signature. Store securely; do not log or disclose it.
integer
required
Shop for which to subscribe to Printify events.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PRINTIFY_DELETE_PRODUCTPermanently delete a product from a Printify shop. This cannot be undone and does not cancel or refund existing orders. Read the product first and verify both IDs before confirming deletion.

Input Parameters

integer
required
Shop ID that owns the product.
string
required
Exact Printify product ID to permanently delete.
boolean
required
Must be true to confirm permanent product deletion. This confirmation is validated locally and not sent to Printify.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PRINTIFY_DELETE_WEBHOOKPermanently delete a Printify webhook subscription so future events are no longer delivered. The expected callback host must match the subscription, which helps prevent deletion of the wrong webhook.

Input Parameters

integer
required
Shop ID that owns the webhook subscription.
string
required
Exact Printify webhook subscription ID to permanently delete.
string
required
Expected callback hostname, such as hooks.example.com. Printify deletes the webhook only when this matches its configured callback host.
boolean
required
Must be true to confirm permanent webhook deletion. This confirmation is validated locally and not sent to Printify.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PRINTIFY_GET_BLUEPRINTGet the full catalog record for one Printify product blueprint, including its description and images. Use SEARCH_BLUEPRINTS first when the blueprint ID is unknown.

Input Parameters

integer
required
Printify catalog blueprint ID returned by SEARCH_BLUEPRINTS or a provider lookup.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PRINTIFY_GET_ORDERGet complete details for one Printify order, including its recipient address, line items, status, shipping method, shipments, and timestamps. This call is read-only. All monetary amounts are integer minor currency units.

Input Parameters

integer
required
Shop ID that owns the order.
string
required
Printify order ID returned by LIST_ORDERS.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PRINTIFY_GET_PRODUCTGet the complete Printify record for one product in a shop, including variants, print areas, images, visibility, and sales-channel properties.

Input Parameters

integer
required
Shop ID that owns the product.
string
required
Printify product ID returned by LIST_PRODUCTS or CREATE_PRODUCT.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PRINTIFY_GET_SHIPPING_DETAILSGet per-variant shipping costs and handling-time ranges for one advertised V2 shipping method. Monetary amounts are integer minor currency units, not decimal major units. Call LIST_SHIPPING_METHODS first and pass only a method it advertised for this blueprint and print provider pair.

Input Parameters

integer
required
Catalog blueprint ID.
string ("standard" | "priority" | "express" | "economy")
required
Method advertised by LIST_SHIPPING_METHODS for this exact blueprint and print provider pair.
integer
required
Compatible print provider ID for the blueprint.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PRINTIFY_LIST_BLUEPRINT_PRINT_PROVIDERSList print providers that can fulfill a specific Printify blueprint. Use a returned provider ID with variant and shipping tools before creating a product.

Input Parameters

integer
required
Catalog blueprint ID whose compatible print providers should be listed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PRINTIFY_LIST_BLUEPRINT_VARIANTSList variants and print placeholders for a blueprint and print provider, with an option to include out-of-stock variants. Variant IDs and available print positions help configure products.

Input Parameters

integer
required
Catalog blueprint ID.
integer
required
Compatible provider ID returned by LIST_BLUEPRINT_PRINT_PROVIDERS.
boolean
Whether to include out-of-stock variants. Sent to Printify as integer 1 when true and 0 when false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PRINTIFY_LIST_ORDERSReturn one page of orders in a Printify shop, optionally filtered by provider status or exact SKU. This is read-only and does not submit, cancel, or send orders to production. All monetary amounts are integer minor currency units.

Input Parameters

string
Optional exact SKU filter.
integer
Maximum orders in this page (1-10).
string
Optional Printify order status filter; pass the provider status string exactly.
integer
required
Shop ID returned by LIST_SHOPS.
string
Opaque continuation cursor returned by a previous call; omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PRINTIFY_LIST_PRODUCTSReturn one page of products in a Printify shop. Use next_cursor to continue without automatically exhausting a potentially large shop catalog.

Input Parameters

integer
Maximum products in this page (1-50).
integer
required
Shop ID returned by LIST_SHOPS.
string
Opaque continuation cursor returned by a previous call; omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PRINTIFY_LIST_SHIPPING_METHODSList the V2 shipping methods actually available for a Printify blueprint and print provider. Availability varies by pair, so call this before requesting method-specific shipping details.

Input Parameters

integer
required
Catalog blueprint ID.
integer
required
Compatible print provider ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PRINTIFY_LIST_SHOPSList shops available to the connected Printify merchant account. Use the returned shop IDs in product, order, and webhook workflows; a shop may be disconnected from a sales channel while remaining readable.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PRINTIFY_LIST_UPLOADSReturn one page of images in the connected merchant’s Printify media library. Use image IDs and preview metadata when configuring product print areas.

Input Parameters

integer
Maximum uploaded images in this page (1-50).
string
Opaque continuation cursor returned by a previous call; omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PRINTIFY_LIST_WEBHOOKSList webhook subscriptions configured for a Printify shop. The live API returns a complete array, so this action does not expose pagination controls.

Input Parameters

integer
required
Shop ID whose webhook subscriptions should be listed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PRINTIFY_PUBLISH_PRODUCTRequest publication of selected product fields to the shop’s connected sales channel; for custom stores, this can trigger an event for the store to handle. Acceptance does not confirm external publication completed.

Input Parameters

integer
required
Shop whose connected sales channel should receive the product changes.
string
required
Product whose selected changes should be published.
array
required
One or more product fields to publish: title, description, images, variants, tags, key_features, or shipping_template.
boolean
required
Must be true to acknowledge that the selected changes may become externally visible. This confirmation is not sent to Printify.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PRINTIFY_SEARCH_BLUEPRINTSSearch Printify’s product blueprint catalog by case-insensitive text in title, brand, or model. The upstream catalog is unpaginated, so this tool fetches it once and returns only bounded matching summaries.

Input Parameters

integer
Maximum number of matching blueprint summaries to return (1-50). This limit is applied locally and is not sent to Printify.
string
required
Text to match case-insensitively against blueprint titles, brands, and models. This filter is applied locally and is not sent to Printify.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PRINTIFY_SIMULATE_WEBHOOKAsk Printify to send a simulated event to an existing webhook’s external callback URL. This causes a real outbound request and may activate downstream automation, but does not create a Printify order or product. A successful response confirms dispatch acceptance only, not callback receipt or processing.

Input Parameters

object
Arbitrary JSON object to use as the simulated event resource. Do not include production secrets or personal data.
integer
required
Shop that owns the webhook subscription.
string
required
Webhook subscription ID whose configured callback receives the simulation.
boolean
required
Must be true to acknowledge that Printify sends a real outbound request that may trigger downstream automation. Validated locally and not sent to Printify.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PRINTIFY_UNPUBLISH_PRODUCTNotify Printify that a product has been unpublished from the connected sales channel. This irreversibly changes publication-state metadata but does not delete the Printify product. Use only after the product has actually been removed or unpublished on the sales channel.

Input Parameters

integer
required
Shop ID associated with the connected sales channel.
string
required
Product ID whose publication state should be marked unpublished.
boolean
required
Must be true to acknowledge the external publication-state change. Validated locally and not sent to Printify.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PRINTIFY_UPDATE_PRODUCTUpdate selected fields of an existing Printify product without publishing changes to the connected sales channel. When updating variants, include all product variants in the request.

Input Parameters

string
Replacement merchant-facing product title.
integer
required
Shop ID that owns the product.
array
Variant updates. Each item identifies a catalog variant and supplies only the price and/or enabled state that should change.
string
required
Printify product ID to update.
string
Replacement product description; an empty string clears it.
array
Complete replacement print-area configuration, including artwork placement for the selected variants.
integer
Replacement blueprint ID. Update the provider, variants, and print areas consistently when changing it.
integer
Replacement print provider ID compatible with the selected blueprint.
string
Replacement product safety information; an empty string clears it.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PRINTIFY_UPDATE_WEBHOOKReplace the callback URL of an existing Printify webhook subscription. This changes where future real event payloads are delivered; it does not change the subscribed topic or signing secret.

Input Parameters

string
required
New public HTTPS callback URL for future webhook events.
integer
required
Shop that owns the webhook.
string
required
Webhook subscription ID returned by LIST_WEBHOOKS or CREATE_WEBHOOK.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: PRINTIFY_UPLOAD_IMAGEAdd an image to the connected merchant’s Printify media library from either a public HTTP(S) URL or base64 content. This creates persistent merchant media but does not create or publish a product or incur production charges.

Input Parameters

string
Publicly retrievable HTTP or HTTPS image URL. Provide exactly one of url or contents.
string
Base64-encoded image bytes. Provide exactly one of contents or url; prefer URL upload for files larger than 5 MB.
string
required
File name, including an appropriate image extension, to store in Printify.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not