What should I know about Printful’s API v2?

This information applies if you use Printful’s API for a custom-built solution or integration.

API v2 is the next major version of Printful’s API and is now available in Open Beta. All endpoints in v2 can be used in a live environment, but the version is still being refined—so small adjustments may be made before the final release. No breaking changes are expected.

What’s new in API v2

Orders

• Flexible order creation: build the order object first, then add items separately.
• More detailed shipment tracking, including estimated delivery dates, departure country, and tracking events.

Webhooks

• HTTPS enforced for secure data exchange.
• Request signing and optional expiration dates for added protection.
• New events, such as price change notifications and real-time stock updates.

Catalog

• Extended product data with advanced filtering.
• Default Selling Region (DSR) support.
• Expanded image and pricing endpoint data.

General improvements

• All timestamps use the ISO 8601 format and UTC time zone.
• Faster response times across all endpoints.

Why join the Open Beta?

• Access the newest API features before the final release.
• Influence the final version by testing and submitting feedback.
• Prepare your systems for a smooth migration from API v1.

How to start using API v2

1. Create or use an existing private API token for authorization.
2. Check the API v2 documentation (BETA) for endpoint details.
3. Build or update your integration using the v2 endpoints.
4. Send your feedback using the API feedback form in the documentation.

Still need help? Our Support Team is here for you—reach out anytime through our contact form or start a chat with us.