Printful API

Name: Printful API
Brand: Printful API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentE CommerceOrder Managementoauth2, basic53 EndpointsREST

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.

Install Jentic One Beta

Connect the Printful API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Printful API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Printful 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

GET STARTED

Start building with Printful API

Explore with Jentic

View OpenAPI Document

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.

Use Cases

Patterns agents use Printful 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

Key Endpoints

53 endpoints — jentic publishes the only available openapi specification for printful api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/products

List all products in the Printful catalog

GET

/products/{id}

Get product details with variants

POST

/orders

Create a new print-on-demand order

POST

/orders/{id}/confirm

Confirm an order for production

POST

/shipping/rates

Calculate shipping rates for items

POST

/mockup-generator/create-task/{id}

Generate product mockup images

GET

/store/products

List synced store products

POST

/files

Upload a design file

GET

/products

List all products in the Printful catalog

GET

/products/{id}

Get product details with variants

POST

/orders

Create a new print-on-demand order

POST

/orders/{id}/confirm

Confirm an order for production

POST

/shipping/rates

Calculate shipping rates for items

Why Jentic?

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.

FAQs

Specific to using Printful 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.

Printful API

Connect the Printful API to your agent

Capabilities

Start building with Printful API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs