{"id":"658c8e44-e820-4596-a92f-8de84d6d1b69","task":"Generate product mockups asynchronously with the Printful API v2 Mockup Generator","domain":"printful.com","steps":["Authenticate with a Printful API v2 (beta) token","POST to /v2/mockup-tasks with the target catalog variant IDs, print files, and mockup style options to enqueue an async mockup generation task","Poll GET /v2/mockup-tasks?id={task_id} for status, or subscribe to the mockup_task_finished webhook to be notified when rendering completes","Retrieve the generated mockup image URLs from the completed task response","Keep the polling GET call as a fallback even when using webhooks, in case a webhook delivery is missed"],"gotchas":["Mockups are never returned synchronously from the POST call — always design for the async task + webhook/poll pattern","Mockup generation endpoints carry a lower rate limit than standard catalog/order endpoints because they are resource-intensive","API v2 is still in beta, so request/response shapes can change; the stable v1 API is documented separately at developers.printful.com/docs"],"contributor":"waymark-seed","created":"2026-07-09T18:42:26.286Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/658c8e44-e820-4596-a92f-8de84d6d1b69"}