# Printify

> Create print-on-demand products, upload artwork, and place and track orders in your Printify shops.

App · 22 actions. Web page: https://docs.lodol.com/docs/integrations/printify

## Actions

### Archive uploaded image

Archive an image in your Printify media library, so it no longer appears there.

**Inputs**

- Image (`image_id`, text, required): The uploaded image.

**Outputs**

- `data` (object): The response from Printify.

**Example output**

```json
{
  "data": {}
}
```

### Calculate shipping cost

Work out what shipping one of your products to an address would cost, by shipping method, in cents.

**Inputs**

- Shop (`shop_id`, text, required): The Printify shop to use.
- Product (`product_id`, text, required): The product to use.
- Variant (`variant_id`, text, required): The product variant to order, such as a size and colour.
- Quantity (`quantity`, number, required): How many to order. At least 1.
- First name (`first_name`, text, required): The recipient's first name.
- Last name (`last_name`, text, required): The recipient's last name.
- Email (`email`, text): The recipient's email address.
- Phone (`phone`, text): The recipient's phone number.
- Country (`country`, text, required): The country to ship to. One of: `AF` (Afghanistan), `AL` (Albania), `DZ` (Algeria), `AS` (American Samoa), `AD` (Andorra), `AO` (Angola), `AI` (Anguilla), `AQ` (Antarctica), `AG` (Antigua & Barbuda), `AR` (Argentina), and 240 more.
- State or region (`region`, text): The state, province or region, for example CA.
- Address line 1 (`address1`, text, required): The street address.
- Address line 2 (`address2`, text): Apartment, suite or unit.
- City (`city`, text, required): The city.
- Postal code (`zip`, text, required): The postal code.

**Outputs**

- `data` (object): The response from Printify.

**Example output**

```json
{
  "data": {
    "economy": 1,
    "express": 1,
    "printify_express": 1,
    "priority": 1,
    "standard": 1
  }
}
```

### Cancel order

Cancel an order that is on hold or whose payment was not received.

**Inputs**

- Shop (`shop_id`, text, required): The Printify shop to use.
- Order (`order_id`, text, required): The order to use.

**Outputs**

- `data` (object): The response from Printify.

**Example output**

```json
{
  "data": {
    "address_to": {
      "city": "example",
      "country": "example",
      "email": "example",
      "first_name": "example",
      "last_name": "example",
      "zip": "example"
    },
    "app_order_id": "example",
    "created_at": "example",
    "fulfilled_at": "example",
    "id": "example",
    "line_items": [
      {
        "cost": 1,
        "product_id": "example",
        "quantity": 1,
        "status": "example",
        "variant_id": 1
      }
    ],
    "sent_to_production_at": "example",
    "shipments": [
      {
        "carrier": "example",
        "delivered_at": "example",
        "number": "example",
        "url": "example"
      }
    ],
    "shipping_method": 1,
    "status": "example",
    "total_price": 1,
    "total_shipping": 1,
    "total_tax": 1
  }
}
```

### Create order

Order one of your products for a customer. Printify charges for it once the order is sent to production.

**Inputs**

- Shop (`shop_id`, text, required): The Printify shop to use.
- Product (`product_id`, text, required): The product to use.
- Variant (`variant_id`, text, required): The product variant to order, such as a size and colour.
- Quantity (`quantity`, number, required): How many to order. At least 1.
- First name (`first_name`, text, required): The recipient's first name.
- Last name (`last_name`, text, required): The recipient's last name.
- Email (`email`, text): The recipient's email address.
- Phone (`phone`, text): The recipient's phone number.
- Country (`country`, text, required): The country to ship to. One of: `AF` (Afghanistan), `AL` (Albania), `DZ` (Algeria), `AS` (American Samoa), `AD` (Andorra), `AO` (Angola), `AI` (Anguilla), `AQ` (Antarctica), `AG` (Antigua & Barbuda), `AR` (Argentina), and 240 more.
- State or region (`region`, text): The state, province or region, for example CA.
- Address line 1 (`address1`, text, required): The street address.
- Address line 2 (`address2`, text): Apartment, suite or unit.
- City (`city`, text, required): The city.
- Postal code (`zip`, text, required): The postal code.
- Shipping method (`shipping_method`, text): How fast to ship. Express, priority and economy need eligible products. One of: `standard`, `priority`, `printify_express` (Printify Express), `economy`. Default: `standard`.
- Send shipping email (`send_shipping_notification`, true/false): Have Printify email the recipient when the order ships.
- Your order ID (`external_id`, text): Your own reference for the order.
- Order label (`label`, text): A label for the order, shown in Printify.

**Outputs**

- `data` (object): The response from Printify.

**Example output**

```json
{
  "data": {
    "id": "example"
  }
}
```

### Create product

Create a product from a catalog blueprint, with one uploaded image printed on the chosen variants.

**Inputs**

- Shop (`shop_id`, text, required): The Printify shop to use.
- Title (`title`, text, required): The product's name.
- Description (`description`, text): The product's description. Printify accepts HTML here.
- Blueprint (`blueprint_id`, text, required): The catalog product type, such as a T-shirt or a mug.
- Print provider (`print_provider_id`, text, required): The print provider that makes this blueprint.
- Variants (`variant_ids`, list, required): The sizes and colours to sell.
- Price (`price`, number, required): The retail price of each variant, in your shop's currency, for example 24.99. At least 0.
- Image (`image_id`, text, required): The uploaded image to print. Upload one with Upload image.
- Print position (`position`, text): Where to print the image, such as front or back. Leave empty to use the blueprint's first print area.
- Tags (`tags`, list): Tags for the product.

**Outputs**

- `data` (object): The response from Printify.

**Example output**

```json
{
  "data": {
    "blueprint_id": 1,
    "id": "example",
    "print_provider_id": 1,
    "title": "example",
    "variants": [
      {
        "id": 1,
        "is_enabled": true,
        "price": 1
      }
    ]
  }
}
```

### Delete product

Delete a product from a shop.

**Inputs**

- Shop (`shop_id`, text, required): The Printify shop to use.
- Product (`product_id`, text, required): The product to use.

**Outputs**

- `data` (object): The response from Printify.

**Example output**

```json
{
  "data": {}
}
```

### Get blueprint shipping info

Get the handling time and shipping costs a print provider charges for a blueprint, by country.

**Inputs**

- Blueprint (`blueprint_id`, text, required): The catalog product type, such as a T-shirt or a mug.
- Print provider (`print_provider_id`, text, required): The print provider that makes this blueprint.

**Outputs**

- `data` (object): The response from Printify.

**Example output**

```json
{
  "data": {
    "handling_time": {
      "unit": "example",
      "value": 1
    },
    "profiles": [
      {
        "additional_items": {
          "cost": 1,
          "currency": "example"
        },
        "countries": [
          "example"
        ],
        "first_item": {
          "cost": 1,
          "currency": "example"
        },
        "variant_ids": [
          1
        ]
      }
    ]
  }
}
```

### Get catalog blueprint

Get one catalog product type, with its brand, model and images.

**Inputs**

- Blueprint (`blueprint_id`, text, required): The catalog product type, such as a T-shirt or a mug.

**Outputs**

- `data` (object): The response from Printify.

**Example output**

```json
{
  "data": {
    "brand": "example",
    "description": "example",
    "id": 1,
    "images": [
      "example"
    ],
    "model": "example",
    "title": "example"
  }
}
```

### Get order

Get an order with its items, costs, status and shipments.

**Inputs**

- Shop (`shop_id`, text, required): The Printify shop to use.
- Order (`order_id`, text, required): The order to use.

**Outputs**

- `data` (object): The response from Printify.

**Example output**

```json
{
  "data": {
    "address_to": {
      "city": "example",
      "country": "example",
      "email": "example",
      "first_name": "example",
      "last_name": "example",
      "zip": "example"
    },
    "app_order_id": "example",
    "created_at": "example",
    "fulfilled_at": "example",
    "id": "example",
    "line_items": [
      {
        "cost": 1,
        "product_id": "example",
        "quantity": 1,
        "status": "example",
        "variant_id": 1
      }
    ],
    "sent_to_production_at": "example",
    "shipments": [
      {
        "carrier": "example",
        "delivered_at": "example",
        "number": "example",
        "url": "example"
      }
    ],
    "shipping_method": 1,
    "status": "example",
    "total_price": 1,
    "total_shipping": 1,
    "total_tax": 1
  }
}
```

### Get product

Get a product with its variants, prices and images.

**Inputs**

- Shop (`shop_id`, text, required): The Printify shop to use.
- Product (`product_id`, text, required): The product to use.

**Outputs**

- `data` (object): The response from Printify.

**Example output**

```json
{
  "data": {
    "blueprint_id": 1,
    "created_at": "example",
    "description": "example",
    "id": "example",
    "images": [
      {
        "is_default": true,
        "position": "example",
        "src": "example"
      }
    ],
    "is_locked": true,
    "print_provider_id": 1,
    "shop_id": 1,
    "tags": [
      "example"
    ],
    "title": "example",
    "updated_at": "example",
    "variants": [
      {
        "cost": 1,
        "id": 1,
        "is_enabled": true,
        "price": 1,
        "sku": "example",
        "title": "example"
      }
    ],
    "visible": true
  }
}
```

### Get uploaded image

Get one image from your Printify media library.

**Inputs**

- Image (`image_id`, text, required): The uploaded image.

**Outputs**

- `data` (object): The response from Printify.

**Example output**

```json
{
  "data": {
    "file_name": "example",
    "height": 1,
    "id": "example",
    "mime_type": "example",
    "preview_url": "example",
    "size": 1,
    "upload_time": "example",
    "width": 1
  }
}
```

### List blueprint variants

List the sizes and colours a print provider offers for a blueprint, with their print areas.

**Inputs**

- Blueprint (`blueprint_id`, text, required): The catalog product type, such as a T-shirt or a mug.
- Print provider (`print_provider_id`, text, required): The print provider that makes this blueprint.
- Include out of stock (`include_out_of_stock`, true/false): Also list variants that are out of stock.

**Outputs**

- `data` (object): The response from Printify.

**Example output**

```json
{
  "data": {
    "id": 1,
    "title": "example",
    "variants": [
      {
        "id": 1,
        "options": {},
        "placeholders": [
          {
            "height": 1,
            "position": "example",
            "width": 1
          }
        ],
        "title": "example"
      }
    ]
  }
}
```

### List catalog blueprints

List every product type in Printify's catalog, such as T-shirts, mugs and posters.

**Inputs**: None.

**Outputs**

- `data` (list): The response from Printify.

**Example output**

```json
{
  "data": [
    {
      "brand": "example",
      "description": "example",
      "id": 1,
      "model": "example",
      "title": "example"
    }
  ]
}
```

### List orders

List a shop's orders, newest first, optionally only those with one status.

**Inputs**

- Shop (`shop_id`, text, required): The Printify shop to use.
- Status (`status`, text): Only orders with this status. One of: `pending`, `on-hold` (On hold), `sending-to-production` (Sending to production), `in-production` (In production), `canceled`, `fulfilled`, `partially-fulfilled` (Partially fulfilled), `payment-not-received` (Payment not received), `has-issues` (Has issues), `cost-calculation` (Calculating cost), `unfulfillable`.
- SKU (`sku`, text): Only orders that include this product SKU.
- Results per page (`limit`, number): How many results to return per page, up to 50 (Printify's default is 10). From 1 to 50.
- Page (`page`, number): Which page of results to return, starting at 1. At least 1.

**Outputs**

- `data` (object): The response from Printify.

**Example output**

```json
{
  "data": {
    "current_page": 1,
    "data": [
      {
        "address_to": {
          "city": "example",
          "country": "example",
          "email": "example",
          "first_name": "example",
          "last_name": "example",
          "zip": "example"
        },
        "app_order_id": "example",
        "created_at": "example",
        "fulfilled_at": "example",
        "id": "example",
        "line_items": [
          {
            "cost": 1,
            "product_id": "example",
            "quantity": 1,
            "status": "example",
            "variant_id": 1
          }
        ],
        "sent_to_production_at": "example",
        "shipments": [
          {
            "carrier": "example",
            "delivered_at": "example",
            "number": "example",
            "url": "example"
          }
        ],
        "shipping_method": 1,
        "status": "example",
        "total_price": 1,
        "total_shipping": 1,
        "total_tax": 1
      }
    ],
    "last_page": 1,
    "per_page": 1,
    "total": 1
  }
}
```

### List print providers for a blueprint

List the print providers that make a catalog blueprint.

**Inputs**

- Blueprint (`blueprint_id`, text, required): The catalog product type, such as a T-shirt or a mug.

**Outputs**

- `data` (list): The response from Printify.

**Example output**

```json
{
  "data": [
    {
      "id": 1,
      "title": "example"
    }
  ]
}
```

### List products

List the products in a shop, newest first.

**Inputs**

- Shop (`shop_id`, text, required): The Printify shop to use.
- Results per page (`limit`, number): How many results to return per page, up to 50 (Printify's default is 50). From 1 to 50.
- Page (`page`, number): Which page of results to return, starting at 1. At least 1.

**Outputs**

- `data` (object): The response from Printify.

**Example output**

```json
{
  "data": {
    "current_page": 1,
    "data": [
      {
        "blueprint_id": 1,
        "created_at": "example",
        "description": "example",
        "id": "example",
        "images": [
          {
            "is_default": true,
            "position": "example",
            "src": "example"
          }
        ],
        "is_locked": true,
        "print_provider_id": 1,
        "shop_id": 1,
        "tags": [
          "example"
        ],
        "title": "example",
        "updated_at": "example",
        "variants": [
          {
            "cost": 1,
            "id": 1,
            "is_enabled": true,
            "price": 1,
            "sku": "example",
            "title": "example"
          }
        ],
        "visible": true
      }
    ],
    "last_page": 1,
    "per_page": 1,
    "total": 1
  }
}
```

### List shops

List the shops in your Printify account.

**Inputs**: None.

**Outputs**

- `data` (list): The response from Printify.

**Example output**

```json
{
  "data": [
    {
      "id": 1,
      "sales_channel": "example",
      "title": "example"
    }
  ]
}
```

### List uploaded images

List the images in your Printify media library, newest first.

**Inputs**

- Results per page (`limit`, number): How many results to return per page, up to 50 (Printify's default is 10). From 1 to 50.
- Page (`page`, number): Which page of results to return, starting at 1. At least 1.

**Outputs**

- `data` (object): The response from Printify.

**Example output**

```json
{
  "data": {
    "current_page": 1,
    "data": [
      {
        "file_name": "example",
        "height": 1,
        "id": "example",
        "mime_type": "example",
        "preview_url": "example",
        "size": 1,
        "upload_time": "example",
        "width": 1
      }
    ],
    "last_page": 1,
    "per_page": 1,
    "total": 1
  }
}
```

### Publish product

Publish a product to the store the shop is connected to, such as Shopify or Etsy, with its title, description, images, variants and tags.

**Inputs**

- Shop (`shop_id`, text, required): The Printify shop to use.
- Product (`product_id`, text, required): The product to use.

**Outputs**

- `data` (object): The response from Printify.

**Example output**

```json
{
  "data": {}
}
```

### Send order to production

Send an order to production. Printify charges for it and starts printing.

**Inputs**

- Shop (`shop_id`, text, required): The Printify shop to use.
- Order (`order_id`, text, required): The order to use.

**Outputs**

- `data` (object): The response from Printify.

**Example output**

```json
{
  "data": {
    "id": "example"
  }
}
```

### Update product

Change a product's title, description, tags or price. Anything left empty stays as it is.

**Inputs**

- Shop (`shop_id`, text, required): The Printify shop to use.
- Product (`product_id`, text, required): The product to use.
- Title (`title`, text): The new name.
- Description (`description`, text): The new description.
- Tags (`tags`, list): The new tags, replacing the current ones.
- Price (`price`, number): A new retail price for every variant, in your shop's currency, for example 24.99. At least 0.

**Outputs**

- `data` (object): The response from Printify.

**Example output**

```json
{
  "data": {
    "blueprint_id": 1,
    "created_at": "example",
    "description": "example",
    "id": "example",
    "images": [
      {
        "is_default": true,
        "position": "example",
        "src": "example"
      }
    ],
    "is_locked": true,
    "print_provider_id": 1,
    "shop_id": 1,
    "tags": [
      "example"
    ],
    "title": "example",
    "updated_at": "example",
    "variants": [
      {
        "cost": 1,
        "id": 1,
        "is_enabled": true,
        "price": 1,
        "sku": "example",
        "title": "example"
      }
    ],
    "visible": true
  }
}
```

### Upload image

Add an image to your Printify media library from a public link, ready to print on products.

**Inputs**

- File name (`file_name`, text, required): The image's file name, such as logo.png.
- Image URL (`url`, text, required): A public link to the image, starting with https://.

**Outputs**

- `data` (object): The response from Printify.

**Example output**

```json
{
  "data": {
    "file_name": "example",
    "height": 1,
    "id": "example",
    "mime_type": "example",
    "preview_url": "example",
    "size": 1,
    "upload_time": "example",
    "width": 1
  }
}
```
