Printcart icon

Printcart

Consume Prinrcart API

Actions80

Overview

This node integrates with the Printcart API to manage "Sides" of products in a print-on-demand or product customization platform. Specifically, the Create Side operation allows users to add a new side to an existing product by specifying details such as background type, color, scale, image size, design area, and status.

Typical use cases include:

  • Adding a new printable side (e.g., front, back, sleeve) to a customizable product.
  • Defining visual and layout properties for that side to control how designs are applied.
  • Automating product setup workflows where multiple sides need to be created programmatically.

For example, a user could create a new side called "Front" for a T-shirt product, set its background color to white, specify the scale and dimensions, assign an image ID representing the side's base image, and mark it as published.

Properties

Name Meaning
Authentication Method of authentication; currently supports only "API Token".
Product ID The unique identifier of the product to which the side will be added.
Name of the Side The name assigned to the side (e.g., "Front", "Back").
Background Type The type of background for the side; options: Color, Image, Transparent.
Background Color Value The color value used if the background type is Color.
Scale The scale factor for the side (percentage).
Width Width dimension of the side image size.
Height Height dimension of the side image size.
Width Arena Width of the design arena area on the side.
Height Arena Height of the design arena area on the side.
Top Arena Top offset position of the design arena area.
Left Arena Left offset position of the design arena area.
Side Image ID Identifier of the side image resource associated with this side.
Status Status of the side; options: Publish, Draft, Trashed.

Output

The node outputs JSON data representing the response from the Printcart API after creating the side. This typically includes all details of the newly created side such as its ID, name, background settings, scale, image sizes, design arena dimensions, associated image IDs, and status.

No binary data output is indicated.

Dependencies

  • Requires an API token credential for authenticating requests to the Printcart API.
  • The node makes HTTP requests to the Printcart API endpoints using the provided credentials.
  • No additional external dependencies beyond the API and n8n's HTTP request helper.

Troubleshooting

  • Authentication errors: Ensure the API token credential is valid and has sufficient permissions.
  • Missing required fields: The node requires productId, name, bg_color_value, scale, side_image_id, and status to be provided. Omitting these will likely cause API errors.
  • Invalid values: Providing invalid color codes, non-numeric scale, or incorrect image IDs may result in API validation errors.
  • API connectivity issues: Network problems or incorrect API endpoint URLs can cause request failures.
  • Error messages: The node throws errors returned by the Printcart API. Review the error message for clues, such as missing parameters or unauthorized access.

To resolve issues:

  • Double-check all required input properties.
  • Verify API token validity.
  • Inspect error messages for specific API feedback.
  • Confirm network connectivity to the Printcart API.

Links and References

Discussion