> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Printify

> Printify is a print-on-demand platform for managing merchant shops, products, orders, uploads, catalog data, and webhooks.

![Printify logo](https://mintcdn.com/composio-preview/HvfZXDijhFOaKyF5/images/toolkits/printify.svg?fit=max\&auto=format\&n=HvfZXDijhFOaKyF5\&q=85\&s=424ba2726dab4b0b825f57fe0c1ddd68)

* **Category:** ecommerce
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 25
* **Triggers:** 0
* **Slug:** `PRINTIFY`
* **Version:** 20261101\_00

## Tools

> [accordion] Archive Uploaded Image
>
> **Slug:** `PRINTIFY_ARCHIVE_UPLOAD`
>
> Irreversibly 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
>
> **image\_id** `string` *required*
>
> Exact Printify uploaded image ID to archive.
>
> **confirm\_archive** `boolean` *required*
>
> Must be true to confirm archival. This confirmation is validated locally and not sent to Printify.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Calculate Order Shipping
>
> **Slug:** `PRINTIFY_CALCULATE_ORDER_SHIPPING`
>
> Calculate 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
>
> **shop\_id** `integer` *required*
>
> Printify shop used to price the proposed shipment.
>
> **address\_to** `object` *required*
>
> Recipient and postal destination used only to calculate shipping quotes.
>
> **line\_items** `array` *required*
>
> Proposed items in exactly one documented form per entry: existing product and variant, catalog blueprint configuration, or SKU.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Draft Product
>
> **Slug:** `PRINTIFY_CREATE_PRODUCT`
>
> Create 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
>
> **title** `string` *required*
>
> Merchant-facing product title.
>
> **shop\_id** `integer` *required*
>
> Shop in which to create the draft product.
>
> **variants** `array` *required*
>
> Non-empty list of variant IDs, prices, and enabled states.
>
> **description** `string`
>
> Optional product description. Printify accepts HTML for compatible channels.
>
> **print\_areas** `array` *required*
>
> Non-empty list mapping variants to provider print positions and images.
>
> **blueprint\_id** `integer` *required*
>
> Blueprint ID selected from catalog discovery.
>
> **print\_provider\_id** `integer` *required*
>
> Print provider ID verified as compatible with the blueprint.
>
> **safety\_information** `string`
>
> Optional product safety and compliance information.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Webhook
>
> **Slug:** `PRINTIFY_CREATE_WEBHOOK`
>
> Create 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
>
> **url** `string` *required*
>
> Public HTTPS callback URL ready to receive Printify POST requests.
>
> **topic** `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.
>
> **secret** `string`
>
> Optional sensitive HMAC secret used to verify X-Pfy-Signature. Store securely; do not log or disclose it.
>
> **shop\_id** `integer` *required*
>
> Shop for which to subscribe to Printify events.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Product
>
> **Slug:** `PRINTIFY_DELETE_PRODUCT`
>
> Permanently 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
>
> **shop\_id** `integer` *required*
>
> Shop ID that owns the product.
>
> **product\_id** `string` *required*
>
> Exact Printify product ID to permanently delete.
>
> **confirm\_delete** `boolean` *required*
>
> Must be true to confirm permanent product deletion. This confirmation is validated locally and not sent to Printify.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Webhook
>
> **Slug:** `PRINTIFY_DELETE_WEBHOOK`
>
> Permanently 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
>
> **shop\_id** `integer` *required*
>
> Shop ID that owns the webhook subscription.
>
> **webhook\_id** `string` *required*
>
> Exact Printify webhook subscription ID to permanently delete.
>
> **expected\_host** `string` *required*
>
> Expected callback hostname, such as hooks.example.com. Printify deletes the webhook only when this matches its configured callback host.
>
> **confirm\_delete** `boolean` *required*
>
> Must be true to confirm permanent webhook deletion. This confirmation is validated locally and not sent to Printify.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Blueprint
>
> **Slug:** `PRINTIFY_GET_BLUEPRINT`
>
> Get 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
>
> **blueprint\_id** `integer` *required*
>
> Printify catalog blueprint ID returned by SEARCH\_BLUEPRINTS or a provider lookup.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Order
>
> **Slug:** `PRINTIFY_GET_ORDER`
>
> Get 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
>
> **shop\_id** `integer` *required*
>
> Shop ID that owns the order.
>
> **order\_id** `string` *required*
>
> Printify order ID returned by LIST\_ORDERS.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Product
>
> **Slug:** `PRINTIFY_GET_PRODUCT`
>
> Get the complete Printify record for one product in a shop, including variants, print areas, images, visibility, and sales-channel properties.
>
> #### Input Parameters
>
> **shop\_id** `integer` *required*
>
> Shop ID that owns the product.
>
> **product\_id** `string` *required*
>
> Printify product ID returned by LIST\_PRODUCTS or CREATE\_PRODUCT.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Catalog Shipping Details
>
> **Slug:** `PRINTIFY_GET_SHIPPING_DETAILS`
>
> Get 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
>
> **blueprint\_id** `integer` *required*
>
> Catalog blueprint ID.
>
> **shipping\_method** `string ("standard" | "priority" | "express" | "economy")` *required*
>
> Method advertised by LIST\_SHIPPING\_METHODS for this exact blueprint and print provider pair.
>
> **print\_provider\_id** `integer` *required*
>
> Compatible print provider ID for the blueprint.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Blueprint Print Providers
>
> **Slug:** `PRINTIFY_LIST_BLUEPRINT_PRINT_PROVIDERS`
>
> List 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
>
> **blueprint\_id** `integer` *required*
>
> Catalog blueprint ID whose compatible print providers should be listed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Blueprint Variants
>
> **Slug:** `PRINTIFY_LIST_BLUEPRINT_VARIANTS`
>
> List 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
>
> **blueprint\_id** `integer` *required*
>
> Catalog blueprint ID.
>
> **print\_provider\_id** `integer` *required*
>
> Compatible provider ID returned by LIST\_BLUEPRINT\_PRINT\_PROVIDERS.
>
> **include\_out\_of\_stock** `boolean`
>
> Whether to include out-of-stock variants. Sent to Printify as integer 1 when true and 0 when false.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Orders
>
> **Slug:** `PRINTIFY_LIST_ORDERS`
>
> Return 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
>
> **sku** `string`
>
> Optional exact SKU filter.
>
> **limit** `integer`
>
> Maximum orders in this page (1-10).
>
> **status** `string`
>
> Optional Printify order status filter; pass the provider status string exactly.
>
> **shop\_id** `integer` *required*
>
> Shop ID returned by LIST\_SHOPS.
>
> **next\_cursor** `string`
>
> Opaque continuation cursor returned by a previous call; omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Products
>
> **Slug:** `PRINTIFY_LIST_PRODUCTS`
>
> Return one page of products in a Printify shop. Use next\_cursor to continue without automatically exhausting a potentially large shop catalog.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum products in this page (1-50).
>
> **shop\_id** `integer` *required*
>
> Shop ID returned by LIST\_SHOPS.
>
> **next\_cursor** `string`
>
> Opaque continuation cursor returned by a previous call; omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Catalog Shipping Methods
>
> **Slug:** `PRINTIFY_LIST_SHIPPING_METHODS`
>
> List 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
>
> **blueprint\_id** `integer` *required*
>
> Catalog blueprint ID.
>
> **print\_provider\_id** `integer` *required*
>
> Compatible print provider ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Shops
>
> **Slug:** `PRINTIFY_LIST_SHOPS`
>
> List 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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Uploaded Images
>
> **Slug:** `PRINTIFY_LIST_UPLOADS`
>
> Return 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
>
> **limit** `integer`
>
> Maximum uploaded images in this page (1-50).
>
> **next\_cursor** `string`
>
> Opaque continuation cursor returned by a previous call; omit for the first page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Webhooks
>
> **Slug:** `PRINTIFY_LIST_WEBHOOKS`
>
> List webhook subscriptions configured for a Printify shop. The live API returns a complete array, so this action does not expose pagination controls.
>
> #### Input Parameters
>
> **shop\_id** `integer` *required*
>
> Shop ID whose webhook subscriptions should be listed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Publish Product Changes
>
> **Slug:** `PRINTIFY_PUBLISH_PRODUCT`
>
> Request 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
>
> **shop\_id** `integer` *required*
>
> Shop whose connected sales channel should receive the product changes.
>
> **product\_id** `string` *required*
>
> Product whose selected changes should be published.
>
> **fields\_to\_publish** `array` *required*
>
> One or more product fields to publish: title, description, images, variants, tags, key\_features, or shipping\_template.
>
> **confirm\_external\_publish** `boolean` *required*
>
> Must be true to acknowledge that the selected changes may become externally visible. This confirmation is not sent to Printify.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Catalog Blueprints
>
> **Slug:** `PRINTIFY_SEARCH_BLUEPRINTS`
>
> Search 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
>
> **limit** `integer`
>
> Maximum number of matching blueprint summaries to return (1-50). This limit is applied locally and is not sent to Printify.
>
> **query** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Simulate Webhook Event
>
> **Slug:** `PRINTIFY_SIMULATE_WEBHOOK`
>
> Ask 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
>
> **payload** `object`
>
> Arbitrary JSON object to use as the simulated event resource. Do not include production secrets or personal data.
>
> **shop\_id** `integer` *required*
>
> Shop that owns the webhook subscription.
>
> **webhook\_id** `string` *required*
>
> Webhook subscription ID whose configured callback receives the simulation.
>
> **confirm\_external\_delivery** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Mark Product Unpublished
>
> **Slug:** `PRINTIFY_UNPUBLISH_PRODUCT`
>
> Notify 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
>
> **shop\_id** `integer` *required*
>
> Shop ID associated with the connected sales channel.
>
> **product\_id** `string` *required*
>
> Product ID whose publication state should be marked unpublished.
>
> **confirm\_unpublish** `boolean` *required*
>
> Must be true to acknowledge the external publication-state change. Validated locally and not sent to Printify.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Product Draft
>
> **Slug:** `PRINTIFY_UPDATE_PRODUCT`
>
> Update 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
>
> **title** `string`
>
> Replacement merchant-facing product title.
>
> **shop\_id** `integer` *required*
>
> Shop ID that owns the product.
>
> **variants** `array`
>
> Variant updates. Each item identifies a catalog variant and supplies only the price and/or enabled state that should change.
>
> **product\_id** `string` *required*
>
> Printify product ID to update.
>
> **description** `string`
>
> Replacement product description; an empty string clears it.
>
> **print\_areas** `array`
>
> Complete replacement print-area configuration, including artwork placement for the selected variants.
>
> **blueprint\_id** `integer`
>
> Replacement blueprint ID. Update the provider, variants, and print areas consistently when changing it.
>
> **print\_provider\_id** `integer`
>
> Replacement print provider ID compatible with the selected blueprint.
>
> **safety\_information** `string`
>
> Replacement product safety information; an empty string clears it.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Webhook URL
>
> **Slug:** `PRINTIFY_UPDATE_WEBHOOK`
>
> Replace 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
>
> **url** `string` *required*
>
> New public HTTPS callback URL for future webhook events.
>
> **shop\_id** `integer` *required*
>
> Shop that owns the webhook.
>
> **webhook\_id** `string` *required*
>
> Webhook subscription ID returned by LIST\_WEBHOOKS or CREATE\_WEBHOOK.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload Image
>
> **Slug:** `PRINTIFY_UPLOAD_IMAGE`
>
> Add 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
>
> **url** `string`
>
> Publicly retrievable HTTP or HTTPS image URL. Provide exactly one of url or contents.
>
> **contents** `string`
>
> Base64-encoded image bytes. Provide exactly one of contents or url; prefer URL upload for files larger than 5 MB.
>
> **file\_name** `string` *required*
>
> File name, including an appropriate image extension, to store in Printify.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
