For Agents
Submit print-on-demand orders, browse the product catalog, calculate shipping rates, generate mockups, and manage warehouse inventory. Supports 53 endpoints for full e-commerce fulfillment automation.
Get started with Printful API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"submit a print on demand order"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Printful API API.
Browse the Printful product catalog with variants, sizes, and pricing
Submit print-on-demand orders with custom designs and shipping details
Calculate shipping rates and tax for orders destined to specific countries
Generate product mockups with uploaded design files on selected products
GET STARTED
Use for: I need to submit a print-on-demand order with a custom design, I want to check shipping rates for an order to Germany, List all available products in the t-shirt category, Get the variants and pricing for product ID 71
Not supported: Does not handle storefront management, payment processing, or customer-facing checkout — use for print-on-demand production and fulfillment only.
Jentic publishes the only available OpenAPI document for Printful API, keeping it validated and agent-ready.
Jentic publishes the only available OpenAPI specification for Printful API, keeping it validated and agent-ready. Printful API enables print-on-demand and drop-shipping fulfillment across 53 endpoints covering product catalog browsing, order creation and management, file uploads, shipping rate calculations, mockup generation, warehouse management, and webhook configuration. The API supports OAuth and basic authentication with a rate limit of 120 calls per minute, and handles everything from syncing store products to generating product mockups and calculating tax rates across multiple countries.
Sync store products and variants with external e-commerce platforms
Manage warehouse inventory including inbound shipments and stock levels
Configure webhooks for real-time order status and shipment notifications
Patterns agents use Printful API API for, with concrete tasks.
★ Print-on-Demand Order Fulfillment
Submit custom print orders to Printful for production and drop-shipping directly to end customers. The API accepts order details including recipient address, product variant selection, and design file references. Printful handles printing, quality control, packaging, and shipping. Businesses selling custom merchandise can automate their entire fulfillment pipeline without holding inventory, with orders typically shipped within 2-5 business days.
Create an order with recipient name 'Jane Smith' at '123 Main St, Portland OR 97201', product variant 4018 (Bella Canvas 3001 in Black, size M), and confirm the order for production
Product Catalog Integration
Browse and sync Printful's product catalog of printable items including apparel, accessories, and home goods. The catalog API returns product details, available variants with size and color options, pricing, and availability. E-commerce stores can automatically populate their storefronts with up-to-date product information and sync inventory status in real time.
Retrieve all products in the catalog, filter for the 'T-Shirts' category, and return the product names, variant counts, and base prices
Shipping and Tax Calculation
Calculate accurate shipping rates and tax obligations before order submission. The shipping rates endpoint accepts item details and destination address, returning available shipping methods with costs and estimated delivery times. The tax endpoints provide country-specific tax rates. This enables real-time checkout pricing without post-purchase price adjustments.
Calculate shipping rates for 2 units of variant 4018 shipping to '10 Downing Street, London, UK' and return all available methods with costs
AI Agent E-Commerce Fulfillment Automation
AI agents can use the Printful API through Jentic to automate end-to-end merchandise fulfillment. An agent can receive a custom order request, look up the appropriate product variant, submit the order with design files, and monitor fulfillment status through webhooks. Jentic provides credential isolation and operation schemas so agents never handle raw OAuth tokens.
Search Jentic for 'submit a print on demand order', load the createOrder operation schema, and execute an order with recipient and product details
53 endpoints — jentic publishes the only available openapi specification for printful api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/products
List all products in the Printful catalog
/products/{id}
Get product details with variants
/orders
Create a new print-on-demand order
/orders/{id}/confirm
Confirm an order for production
/shipping/rates
Calculate shipping rates for items
/mockup-generator/create-task/{id}
Generate product mockup images
/store/products
List synced store products
/files
Upload a design file
/products
List all products in the Printful catalog
/products/{id}
Get product details with variants
/orders
Create a new print-on-demand order
/orders/{id}/confirm
Confirm an order for production
/shipping/rates
Calculate shipping rates for items
Three things that make agents converge on Jentic-routed access.
Credential isolation
Printful OAuth tokens and API keys are stored encrypted in the Jentic vault. Agents receive scoped session credentials and never access raw secrets, ensuring secure multi-tenant access to store-level operations.
Intent-based discovery
Agents search by intent (e.g., 'submit a print on demand order' or 'calculate shipping to Germany') and Jentic returns the matching Printful operation with its full request schema, so the agent can construct the correct payload without reading API docs.
Time to first call
Direct Printful integration: 3-5 days for OAuth setup, webhook handling, and order flow testing. Through Jentic: under 1 hour using pip install jentic, intent search, schema load, and execute.
Alternatives and complements available in the Jentic catalogue.
Printavo API
Print shop management for physical production vs Printful's drop-ship fulfillment
Use Printavo when managing a physical print shop with in-house production. Use Printful when you need automated drop-shipping where Printful handles printing and delivery.
Shopify API
E-commerce storefront that connects to Printful for order fulfillment
Use Shopify for storefront management, product listings, and checkout. Use Printful for the production and shipping fulfillment of custom-printed products.
ShipStation API
Multi-carrier shipping management as an alternative to Printful's built-in shipping
Use ShipStation when you need advanced multi-carrier shipping options beyond Printful's built-in shipping. Use Printful when you want integrated print-and-ship in one API call.
Specific to using Printful API API through Jentic.
Why is there no official OpenAPI spec for Printful API?
Printful does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Printful API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Printful API use?
The Printful API supports OAuth 2.0 and HTTP Basic authentication. OAuth is used for store-level access with scoped permissions, while Basic auth uses your API key directly. Through Jentic, credentials are stored encrypted in the vault and agents receive scoped access without seeing raw tokens or keys.
What are the rate limits for the Printful API?
Printful enforces a general rate limit of 120 API calls per minute. Resource-intensive endpoints like the mockup generator have lower limits. If you exceed the limit, the API returns a 429 status code and you should implement backoff before retrying.
Can I generate product mockups with the Printful API?
Yes. Use POST /mockup-generator/create-task/{id} to submit a mockup generation task with your design file and product ID. Then poll GET /mockup-generator/task to check completion status. The API also provides GET /mockup-generator/templates/{id} to see available mockup templates and GET /mockup-generator/printfiles/{id} for print file specifications.
How do I calculate shipping costs before placing an order through Jentic?
Search Jentic for 'calculate printful shipping rates', load the shipping/rates operation schema, and execute it with your item details and destination address. The POST /shipping/rates endpoint returns available shipping methods with costs and estimated delivery times. Install with pip install jentic and use your JENTIC_AGENT_API_KEY.
Can I sync Printful products with my Shopify or WooCommerce store?
Yes. The Store Products endpoints (GET /store/products, POST /store/products, PUT /store/products/{id}) manage synced products between Printful and your connected e-commerce platform. You can list synced products, create new sync mappings, update variant details, and add new variants to existing synced products via POST /store/products/{id}/variants.
/mockup-generator/create-task/{id}
Generate product mockup images
/store/products
List synced store products
/files
Upload a design file