Create product with the Printify API
Creates 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.
- Identifier
- printify_create_product
The request
POST https://connect.reportei.com/api/tools/printify_create_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>",
"title": "<title>",
"blueprint_id": 1,
"print_provider_id": 1,
"variants": [],
"print_areas": []
}
}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. |
| title | string | Yes | Name of the product. |
| description | string | No | Description of the product. HTML is accepted where the sales channel supports it. |
| blueprint_id | integer | Yes | Id of the catalog item, from List blueprints or from the blueprint_id of a product in Get product. |
| print_provider_id | integer | Yes | Id of the print provider, from List blueprint print providers. |
| variants | array | Yes | Variants of the blueprint to offer, with the selling price. |
| print_areas | array | Yes | The artwork of each group of variants. |
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_create_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.
- 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.
- Publish productPOSTSends 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.
- 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.
