printful-sdk-js-v2
Advanced tools
Printful SDK for Node.js / TypeScript. A wrapper for the Printful REST API (v2)
A lightweight SDK for interacting with the Printful RESTful API, written in TypeScript. Designed for server-side use in Node.js environments.
🔗 Official API docs: developers.printful.com
📢 Notice: Printful API v2 is currently in beta. While an official release date and roadmap have not yet been announced, most v2 endpoints are already available. This SDK is actively being developed, and breaking changes may occur until the first stable release. If you encounter any issues, feel free to open an issue!
v2.0.0-betaView the site here: spencerlepine.github.io/printful-sdk-js-v2
# npm
npm install printful-sdk-js-v2
# yarn
yarn add printful-sdk-js-v2
# pnpm
pnpm add printful-sdk-js-v2
The package needs to be configured with your private token (create one here).
// getCountries.ts
import { PrintfulClient, Country } from 'printful-sdk-js-v2';
// const { PrintfulClient } = require('printful-sdk-js-v2'); // CommonJS
const printful = new PrintfulClient({
TOKEN: '<PRINTFUL_API_TOKEN>',
});
(async () => {
const response = await printful.countriesV2.getCountries();
const countries: Country[] = response.data;
console.log(countries);
})();
import { PrintfulClient } from 'printful-sdk-js-v2';
const printful = new PrintfulClient({
TOKEN: '<PRINTFUL_API_TOKEN>',
});
| Option | Default | Description |
|---|---|---|
TOKEN | null | The private token for authenticating requests. Generate one at Printful Developers. |
These samples are provided as-is and are not guaranteed to be production-ready. They serve as a starting point for your own implementation.
Pull requests welcome! If you need assistance contributing to this project, please review the CONTRIBUTING.md file to get started.
This SDK is a third-party library and is not officially endorsed or maintained by Printful. It is provided "as is" without warranty of any kind. For official information and guidelines on using the Printful API, please refer to the Printful Developer Documentation.
[2.1.3-beta] - 2025-07-24
FAQs
Printful SDK for Node.js / TypeScript. A wrapper for the Printful REST API (v2)
The npm package printful-sdk-js-v2 receives a total of 51 weekly downloads. As such, printful-sdk-js-v2 popularity was classified as not popular.
We found that printful-sdk-js-v2 demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
/Research
Malicious Nx npm versions stole secrets and wallet info using AI CLI tools; Socket’s AI scanner detected the supply chain attack and flagged the malware.
Security News
CISA’s 2025 draft SBOM guidance adds new fields like hashes, licenses, and tool metadata to make software inventories more actionable.
Security News
A clarification on our recent research investigating 60 malicious Ruby gems.