Print-on-Demand Strategy

How to Use the Mockupanda API to Automatically Generate Poster Mockups When a New SKU Is Added to Your WooCommerce or Shopify Store

By Mockupanda11 min read
How to Use the Mockupanda API to Automatically Generate Poster Mockups When a New SKU Is Added to Your WooCommerce or Shopify Store

Why Manual Mockup Creation Breaks Down at Scale

When you first launched your Etsy or Shopify store, creating mockups for each new product probably felt manageable. You'd upload a design, drop it into a mockup template, export a few images, and attach them to the listing. Twenty minutes, done.

But the moment your catalog starts growing, that workflow becomes a serious problem. If you're running a print-on-demand business with dozens of new SKUs coming in per week, or if you're expanding into WooCommerce alongside your Shopify store, the time cost compounds fast. An hour a day on mockup creation is five hours a week, twenty hours a month, that could be going into design work, marketing, or actually growing your business.

The real kicker is that this task is almost entirely repetitive. You're doing the same set of actions, with slightly different artwork, over and over again. That is exactly the kind of job that should be automated.

The SKU-Level Problem Nobody Talks About

Most guides on automating mockups focus on the design file level, where you trigger generation when a new artwork file is uploaded. But many stores, especially those using WooCommerce or Shopify with multiple variants, organize their catalog at the SKU level. A single design might produce five SKUs: different sizes, finishes, or frame styles. Each of those SKUs ideally needs its own set of mockup images tailored to what it actually represents.

Automating at the SKU level means you can match the mockup style to the product variant, generate only what's relevant for that specific SKU, and keep your listing images consistent without any manual sorting or renaming afterward.

What You Actually Need to Pull This Off

Before jumping into the technical steps, here is a quick inventory of what you need in place:

  • A Mockupanda account with API access enabled

  • Your WooCommerce or Shopify store with the ability to add webhook triggers or use an automation platform like Make (formerly Integromat) or Zapier

  • A basic understanding of what a webhook is (it is essentially a notification your store sends to another service when something happens, like a new product being created)

  • Your design files accessible via a URL, either hosted in your own cloud storage or via your store's media library

You do not need to be a developer to follow this. The non-developer-friendly setup path using no-code tools is a completely valid approach and works well for most store owners.

---

Setting Up Your Mockupanda API Access

The first thing to get sorted is your API credentials. Log into your Mockupanda account and navigate to the API section of your settings. You will find your API key there. Keep this key private, it authenticates every request you make to generate mockups, so treat it like a password.

Once you have your key, spend a few minutes exploring the API documentation. The key endpoint you will be working with is the mockup generation endpoint, which accepts a template ID, your design image URL, and a few optional parameters like output dimensions and file format.

Choosing Your Mockup Templates

Before you can automate anything, you need to decide which mockup templates you want to use for your poster SKUs. Mockupanda offers a range of lifestyle and flat lay templates. The goal here is to pick two or three templates that work well across your product range, so you can consistently apply them to every new SKU without needing to make decisions each time.

For poster and wall art sellers, a good starting set usually includes a framed print hanging on a wall in a living room setting, a rolled or flat print on a light surface, and possibly a close-up detail shot. Note the template IDs for each, because you will reference these in your automation.

A practical tip: map your template choices to SKU attributes. If a SKU is a canvas print, route it to your canvas mockup templates. If it is an unframed print, route it to a flat lay or styled desk shot. This mapping logic can live inside your automation workflow and keeps everything organized.

Testing Your First API Call Manually

Before building any automation, test the API manually using a tool like Postman or even a simple browser-based API tester. Send a POST request to the Mockupanda generation endpoint with your API key in the header, a template ID, and the URL of one of your design files.

If the response comes back with a mockup image URL, you know your credentials are working and the template is rendering correctly. Save that test response, you will refer back to the image URL format when building your workflow.

Actionable takeaway: Get your API key, pick two or three poster mockup templates, note their IDs, and run one successful test call before moving to automation. This foundation step prevents a lot of debugging headaches later.

---

Building the WooCommerce Automation

WooCommerce gives you a couple of ways to trigger an action when a new SKU is created. The most reliable approach for non-developers is using a webhook, which WooCommerce supports natively.

Configuring the WooCommerce Webhook

Inside your WordPress admin panel, go to WooCommerce, then Settings, then Advanced, and then Webhooks. Create a new webhook and set the Topic to "Product created" or "Product updated," depending on whether you want to trigger mockup generation only on new SKUs or also when existing ones are modified.

Set the Delivery URL to the endpoint your automation platform provides. If you are using Make, you will create a new scenario with a Webhook module and it will give you a unique URL to paste here. If you are using Zapier, the process is similar via their Webhook trigger.

The webhook payload WooCommerce sends will include the product ID, the product name, the SKU, any variation data, and the product images already attached. You will use this data in the next step to pull out the design file URL.

Building the Automation Flow in Make or Zapier

Once your webhook is receiving data, the automation flow looks like this:

  1. Receive the webhook payload from WooCommerce when a new SKU is created

  2. Parse the payload to extract the design file URL and any relevant SKU attributes like size or product type

  3. Use a conditional step to select the right Mockupanda template ID based on those attributes

  4. Send an HTTP POST request to the Mockupanda API with the template ID and design URL

  5. Receive the generated mockup image URL in the response

  6. Send a follow-up request back to WooCommerce via its REST API to attach the new mockup image to the product

Step four is where you use the Mockupanda API key in the Authorization header. The request body is typically a JSON object with the template ID and the image URL as parameters, and you may also pass output format preferences like JPG or PNG and a specific resolution.

Step six closes the loop. WooCommerce's REST API lets you update a product's images array using a PATCH or PUT request to the product endpoint. You will add the new mockup URL to the images field so it appears on the product page automatically.

Actionable takeaway: Set up one complete WooCommerce to Mockupanda to WooCommerce loop using Make or Zapier before scaling. Test it with a staging product and confirm the mockup image actually appears on the product page before running it live.

---

Building the Shopify Automation

Shopify's approach is slightly different but follows the same logic. Shopify has a robust webhook system and works seamlessly with both Make and Zapier, making the automation fairly straightforward to configure.

Shopify admin webhooks settings page
Shopify admin webhooks settings page

Setting Up a Shopify Webhook for Product Creation

In your Shopify admin, go to Settings, then Notifications, and scroll to the bottom where you will find the Webhooks section. Create a new webhook and set the event to "Product creation." Paste in the delivery URL from your automation platform.

Shopify sends a rich JSON payload that includes the product ID, title, handle, variants, and any images already attached. The variants object is particularly useful here because it contains the SKU string for each variant, which you can use to route to different mockup templates.

If your store uses Shopify's variant system (for example, different sizes of the same poster design each having their own SKU), you may want to loop through each variant in your automation and generate a mockup for each one. Make handles this well with its iterator module, which processes each item in an array one by one.

Attaching Generated Mockups Back to Shopify Products

Shopify's Admin API has a straightforward endpoint for adding images to a product. After you receive the mockup URL from Mockupanda, send a POST request to the Shopify product images endpoint with the product ID and the new image URL.

You can also set the alt text for the image in the same request, which is worth doing for SEO purposes. A good format for alt text is something like the product title plus the variant name plus "mockup," all written naturally.

For stores running both Shopify and WooCommerce simultaneously, which is more common than you might think among sellers who started on one platform and expanded to the other, you can run two parallel branches in your automation. One branch handles the Shopify update, the other handles WooCommerce. Both branches receive the same mockup image URL from a single Mockupanda API call, so you only pay for one generation.

This approach builds on the same principles covered when populating a new Shopify product page with listing images on creation, and extending it to cover WooCommerce in parallel is a natural next step for multi-channel sellers.

Actionable takeaway: If you run both Shopify and WooCommerce, build your automation so the Mockupanda API call happens once and the resulting image URL is sent to both platforms. This keeps costs down and ensures consistency across channels.

---

Handling Edge Cases and Error States

No automation runs perfectly 100 percent of the time. Design files occasionally have formatting issues, API calls time out, or a webhook payload arrives malformed. Building in some basic error handling will save you from discovering a backlog of products with missing images weeks later.

Validating the Design File URL Before Calling the API

Before sending a request to the Mockupanda API, add a validation step in your automation to check that the design file URL is actually present and accessible. In Make, you can use a filter module that only continues the flow if the URL field is not empty. In Zapier, you can use a Filter step with the same logic.

You can also add a check for the file extension. If your design files are always PNGs or JPGs, filter out anything that does not match those formats before it reaches the API call. This prevents wasted API calls on thumbnail images or placeholder files that sometimes sneak into product records.

Setting Up Failure Notifications

When an API call fails, you want to know about it immediately rather than discovering it later. Both Make and Zapier let you add error handlers to specific steps. Configure your HTTP request module to send you an email or a Slack message if the Mockupanda API returns anything other than a 200 success response.

Include useful context in that notification: the product ID, the SKU, and the error message from the response body. This makes it easy to investigate and manually fix the product if needed, or re-trigger the automation once the underlying issue is resolved.

Using webhooks in combination with the API, the way outlined in the webhook-based mockup generation workflow, gives you a reliable event-driven system where nothing slips through the cracks as long as your error handling is solid.

Actionable takeaway: Add a URL validation filter before every API call and set up a simple failure notification so you know immediately when something goes wrong. A five-minute setup here saves hours of troubleshooting later.

---

Scaling the System as Your Catalog Grows

Once the automation is running reliably for a handful of new SKUs, the natural next question is how well it holds up as your volume increases. The good news is that the architecture described here scales well without any major changes.

Batching and Rate Limits

If you ever add a large batch of new products at once, perhaps after a seasonal collection launch or a CSV import, your webhook will fire many times in quick succession. Most automation platforms handle queuing automatically, but it is worth checking the rate limits on both your platform and the Mockupanda API to make sure you are not sending more requests per second than is allowed.

If you anticipate large batch uploads regularly, consider adding a small delay between iterations in your automation flow. In Make, this is a simple Sleep module. It slows things down slightly but keeps you well within rate limits and prevents any requests from being dropped.

Expanding to Multiple Mockup Styles Per SKU

Once the single-mockup-per-SKU flow is solid, you can expand it to generate multiple mockup styles for each new SKU. This means your automation makes two or three separate API calls per SKU, each with a different template ID, and attaches all the resulting images to the product listing.

This is where auto-generating mockups for every new design across your print-on-demand store becomes especially relevant, because the same multi-template logic applies directly. You end up with a fully stocked product page, with a lifestyle shot, a flat lay, and a detail image, all generated automatically and consistently every single time.

Actionable takeaway: Start with one mockup per SKU and get that running smoothly first. Once it is stable for a few weeks, expand to multiple templates per SKU. Do not try to build everything at once or debugging becomes much harder.

---

Making the Investment Pay Off

The time you put into building this automation, probably a few hours across a weekend, pays back in a very concrete way. If you add ten new SKUs per week and each one previously took fifteen minutes to mockup manually, that is two and a half hours per week you are reclaiming. Over a year, that is more than 130 hours.

Beyond time, there is the consistency benefit. Automated mockups follow the same templates every time, which means your store looks cohesive even as your catalog grows to hundreds of products. Buyers browsing your shop see a unified visual identity rather than a patchwork of different mockup styles from different points in your store's history.

And because Mockupanda is built specifically for print-on-demand and wall art sellers, the templates are already optimized for the kinds of products you are selling. You are not adapting a generic tool to fit your use case, you are using something designed from the ground up for exactly this workflow.

If your store is on WooCommerce, Shopify, or both, and you are adding new SKUs regularly, the automation described in this guide is one of the highest-leverage operational improvements you can make this year. Set it up once, test it thoroughly, and let it run in the background while you focus on the parts of your business that actually require your creative attention.