Internet of Things

Printful

13min

The Printful modules allow you to watch, create, update, retrieve, and delete the orders in your Printful account.

Warning

From September 30, 2022, Printful has disabled the creation of legacy API tokens.

Starting March 30, 2023, the Printful API will no longer be accessible using legacy API keys. To avoid losing access to the Printful API, customers will be required to migrate to the new API tokens. The new tokens are more secure and offer greater customization. For more information, see the Printful API key migration documentation.

To get started with Printful, create an account at printful.com/auth/register.

Connect Printful to Make

To connect to the Printful app:

  1. Log in to Make, add any Printful module to the Make, click the Add button next to the Connection field, and select the connection type as Printful OAuth.

    _27_43.png
    
  2. Optional: In the Connection name field, enter a name for the connection.
  3. Optional: Click Show Advanced Settings, and enter the client credentials of your custom app.
  4. Click Save.

You have successfully established the connection. You can now edit your Make and add more Printful modules. If your connection needs reauthorization at any point, follow the connection renewal steps here.

Obtain Client Credentials

You need to create a custom app to generate client credentials.

  1. Click Create App.
  2. Enter the details as mentioned below:
  3. Click Create app.
  4. Copy the Client ID and Secret Key to a safe place.

    Document image
    

You have successfully retrieved the client credentials.

Orders

Watch Orders

Watches for new orders.

Field

Description

Connection

Establish a connection to your Printful account.

Limit

Set the maximum number of new orders Make should return during one Make execution cycle.

Watch Fulfilled Orders

Watches for orders which have been fulfilled (all items shipped successfully).

Field

Description

Connection

Establish a connection to your Printful account.

Limit

Set the maximum number of fulfilled orders Make should return during one Make execution cycle.

Watch Canceled Orders

Watches for new canceled orders.

Field



Connection

Establish a connection to your Printful account.

Limit

Set the maximum number of canceled orders Make should return during one Make execution cycle.

Get an Order

Returns information about an order.

Field

Description

Connection

Establish a connection to your Printful account.

Order ID

Select the Order ID whose details you want to retrieve.

Create an Order

Creates an order.

Field

Description

Connection

Establish a connection to your Printful account.

Product ID

Select the Product ID for which you are creating the order.

Quantity

Enter the number of product items being ordered.

URL

Enter the URL address of the Printfile being ordered.

Name

Enter the recipient's name.

Address Line 1

Enter the recipient's street address.

City

Enter the recipient's city name.

Country Code

Enter the recipient's two-letter country code. For example, the US for the United States.

ZIP (Postal Code)

Enter the recipient's area postal code.

State Code

Enter the recipient's two-digit state code. For example, AK for Alaska.

Company Name

Enter the recipient's company name.

Address Line 2

Enter the recipient company's street address.

State Name

Enter the recipient company's state name.

Country Name

Enter the recipient company's country name.

Phone

Enter the recipient's phone number.

Email

Enter the recipient's email address.

Update an Order

Updates an unsubmitted order and optionally submits it for fulfillment.

Field

Description

Connection

Establish a connection to your Printful account.

Order ID

Select the Order ID whose details you want to update.

Product ID

Select the Product ID for which you are creating the order.

Quantity

Enter the number of product items being ordered.

URL

Enter the URL address of the Printfile.

Name

Enter the recipient's name.

Address Line 1

Enter the recipient's street address.

City

Enter the recipient's city name.

Country Code

Enter the recipient's two-letter country code. For example, the US for United States.

ZIP (Postal Code)

Enter the recipient's area postal code.

State Code

Enter the recipient's two-digit state code. For example, AK for Alaska.

Company Name

Enter the recipient's company name.

Address Line 2

Enter the recipient company's street address.

State Name

Enter the recipient company's state name.

Country Name

Enter the recipient company's country name.

Phone

Enter the recipient's phone number.

Email

Enter the recipient's email address.

Cancel an Order

Cancels a pending or draft order.

Field

Description

Connection

Establish a connection to your Printful account.

Order ID

Select the Order ID you want to cancel.

Others

Make an API Call

Performs an arbitrary authorized API call.

Field

Description

Connection

Establish a connection to your Printful account.

URL

Enter a path relative to https://api.printful.com/. For example: /orders/estimate-costs

Method

Select the HTTP method you want to use:

  • GET: to retrieve information for an entry.
  • POST: to create a new entry.
  • PUT: to update/replace an existing entry.
  • PATCH: to make a partial entry update.
  • DELETE: to delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.



Example of Use - List Orders

The following API call returns all the orders from your Printfile account:

URL:

/orders

Method:

GET

Document image


Matches of the search can be found in the module's Output under Bundle > Body > result.

In our example, 4 orders were returned:

Document image