OAuth2 Tokens

In this release, you'll be able to make requests using the new OAuth2 tokens.

Legacy keys will be phased out on September 30th, 2022.

Products API

You can now use Products API with our SDK. Refer to our API docs for more insights at https://www.printful.com/docs/products

Added orientation parameter for mockup generator print file retrieval method.

You now can retrieve print files in a specific orientation (just like for templates) if that product supports multiple orientations (e.g. wall art).

Option to retrieve specific orientation templates for wall art.

You can now retrieve templates wall art in specific orientation - horizontal or vertical.
New field added: \Printful\Structures\Generator\Templates\TemplateItem::$orientation

\Printful\PrintfulMockupGenerator::getProductTemplates signature changed to include an optional orientation parameter.

MockupExtraItem will include option and optionGroup fields.

v2.2.7

MockupExtraItem will include group and option group.

Webhook list updated

New webhook types:

    /** Is called when order is put on hold. */
    const TYPE_ORDER_PUT_HOLD = 'order_put_hold';
    /** Is called when order is removed from hold. */
    const TYPE_ORDER_REMOVE_HOLD = 'order_remove_hold';
    /** Is called when a shipment is processed as returned to the fulfillment facility. */
    const TYPE_PACKAGE_RETURNED = 'package_returned';

Mockup generator. Allow setting product options for task

v2.2.5

Mockup Generator. Allow passing product options when creating task.

Method to fetch order costs (order price calculation)

You can now calculate all costs through a method call by passing the same order object that would be used when submitting an actual order.

"Top" placement added (bikinis), tests updated

v2.2.3

Added TOP placement and test for bikini generation.

Minor updates

Embroidery shirt placement.