Printify SDK for TypeScript (Node.js)

Printify SDK for Node.js. A basic TypeScript wrapper for the Printify REST API (v1). Guidelines and source endpoints can be found here: developers.printify.com.

Getting started

Prerequisites

• Printify Personal Access Token (create one here)

Installation

# Npm
npm install printify-sdk-js

# Yarn
yarn add printify-sdk-js

# Pnpm
pnpm add printify-sdk-js

Usage

⚠️ For security purposes, this is intended only for server-side use, the API does not support CORS and will not process requests from a frontend application

# generate a token: https://printify.com/app/account/api
export PRINTIFY_API_TOKEN="asdfASDFasdfASDFasdfASDF"

# fetch your shopId
curl -X GET https://api.printify.com/v1/shops.json --header "Authorization: Bearer $PRINTIFY_API_TOKEN"
# Expected response: [{"id":1234567,"title":"My Store Name","sales_channel":"custom_integration"}]

# store for process.env.PRINTIFY_API_TOKEN
echo "PRINTIFY_API_TOKEN=\"$PRINTIFY_API_TOKEN\"" >> .env

import Printify from 'printify-sdk-js';
// const Printify = require('printify-sdk-js'); // CommonJS

const printify = new Printify({
  shopId: '123456', // global query by shop_id
  accessToken: process.env.PRINTIFY_API_TOKEN,
  enableLogging: true, // on by default
});

const orderData = {
  label: order_123456,
  line_items: [
    {
      print_provider_id: '12345',
      blueprint_id: '67890',
      variant_id: '112233',
      print_areas: {
        front: 'https://example.com/path/to/sticker.png', // **must be public
      },
      quantity: 1,
    },
    // ...
  ],
  shipping_method: 1,
  is_printify_express: false,
  is_economy_shipping: false,
  send_shipping_notification: true, // send email
  address_to: {
    first_name: 'John',
    last_name: 'Doe',
    email: '[email protected]',
    phone: '0574 69 21 90',
    country: 'US',
    region: 'NY',
    address1: '123 Main Street',
    address2: '',
    city: 'New York',
    zip: '10001',
  },
};

try {
  const result = await printify.orders.submit(orderData);
  console.log(result); // { "id": "5a96f649b2439217d070f507" }
} catch (error) {
  console.error('Error submitting order:', error);
}

API

For the full documentation, please see API.md

• Shops - printify.shops.*
• Catalog - printify.catalog.*
• Products - printify.products.*
• Orders - printify.orders.*
• Uploads - printify.uploads.*
• Webhooks - printify.webhooks.*

Contributing

We welcome contributions from the community! If you're interested in contributing to this project, please read the CONTRIBUTING.md file to get started.

Disclaimer

This SDK is a third-party library and is not officially endorsed or maintained by Printify. It is provided "as is" without warranty of any kind. For official information and guidelines on using the Printify API, please refer to the Printify Developer Documentation.

License

MIT