Publish product with the Printify API
Sends a product to the sales channel of the shop, such as Shopify or Etsy, and locks it in Printify until the channel confirms; in a shop connected by API, that store has to confirm. Each true field is pushed, false keeps what the channel has. Limited to 200 calls every 30 minutes.
- Identifier
- printify_publish_product
The request
POST https://connect.reportei.com/api/tools/printify_publish_product/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"shop_id": "<shop_id>",
"product_id": "<product_id>",
"title": true,
"description": true,
"images": true,
"variants": true,
"tags": true
}
}Your system sends your customer's connection id and the tool arguments. The headers are the same as the rest of the Connect API: your product's token and your customer's token.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| shop_id | string | Yes | Id of the shop, from List shops. |
| product_id | string | Yes | Id of the product, from List products. |
| title | boolean | Yes | true publishes the title. |
| description | boolean | Yes | true publishes the description. |
| images | boolean | Yes | true publishes the mockup images. |
| variants | boolean | Yes | true publishes the variants and their prices. |
| tags | boolean | Yes | true publishes the tags. |
| keyFeatures | boolean | No | true publishes the key features. |
| shipping_template | boolean | No | true publishes the shipping template. Only Etsy and Amazon use it. |
Supported connections
Your customer connects their Printify account once, with one of the modes below. The same connection serves every tool of the toolkit.
API key
Your customer pastes the app's key on a Connect screen, or your system sends the key with POST /api/customer-toolkits, with no screen.
The response
On success, Connect preserves the app's response status and body. HTTP errors returned by the app use the {error, api_error} envelope; authentication or validation can fail before execution. The X-Toolkit-Execution-Id header identifies the recorded execution, available at GET /api/tools/executions/{uuid}.
Ready for AI agents
This tool's input is a JSON Schema, available at GET /api/tools/printify_publish_product. It becomes your agent's tool definition with no conversion.
Other Printify tools
- List shopsGETLists the shops of the account with id, title and sales_channel, such as shopify, etsy or disconnected. The id is the shop_id that every other tool asks for.
- List productsGETLists the products of a shop with title, description, tags, variants with price in cents, mockup images, blueprint_id, print_provider_id and publishing status. 10 per page by default; current_page and last_page come in the response.
- Get productGETReturns a product: title, description, tags, options, variants with sku, price and cost in cents, print areas with the images and their position, mockups, is_locked and the links to the sales channel.
- Create productPOSTCreates a product in a shop from a catalog blueprint, a print provider, the variants to sell with their prices and the uploaded images placed on each print area. A low resolution image is refused with error 8203. The product is not published: use Publish product.
- Update productPUTChanges a product and returns it. Only the fields sent change, but variants must list every variant of the product. Refused while is_locked is true, during a publication. Changes reach the sales channel only after Publish product.
- List ordersGETLists the orders of a shop with status, line items, address, costs in cents and shipments with tracking. 10 per page at most; current_page and last_page come in the response.
- Get orderGETReturns an order: status, line items with their production status, shipping address, costs in cents, shipments with carrier and tracking, and the dates of creation, production and fulfillment.
- List blueprintsGETLists the whole Printify catalog of blank products, called blueprints, with id, title, brand, model and images, in one long response. Prefer the blueprint_id of an existing product when one fits.
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
