Expect repeat notifications
Webhook delivery may be retried. Validate authenticity and make processing idempotent. Store job identity rather than treating every notification as new work. The API reference documents delivery and retry behavior.
Automation
4 min read · Reviewed How to Automate Mockup Generation with the API
Automate after one template and artwork combination produces an acceptable result. Completion time depends on the template, resolution, queue and workload. Use background jobs when your workflow cannot wait for an image response.
Your trigger
New artwork or an order
Render API
Template + design + settings
Background render jobSigned webhook
Verify the completion event
Continue your workflow- 1
Prepare inputs
Import and inspect the template, upload reusable artwork, and record IDs and required slot names. Review compatibility and perform one small render before generating a large set.
- 2
Create a server-side key
Create a named, revocable API key. Send it in an Authorization: Bearer header from your server or automation service. Keep it out of browser code, screenshots and exported workflows.
- 3
Submit the request
Prefer a JSON POST /api/v1/render-jobs for a background job. Keep options as an object, use owned asset IDs in exact slots and send a stable Idempotency-Key header. Save the accepted job ID. Multipart file uploads remain supported; synchronous renders return image bytes and have no submission deduplication.
- 4
Verify completion
Poll job status or receive signed webhooks. Verify signatures on raw request bodies with the configured secret and process duplicate notifications safely. Distinguish validation, quota and temporary service errors before retrying.
- 5
Scale an approved setup
Use collections for a design, template and color matrix. Check estimates and a sample first, then inspect the manifest and partial failures. Archive the configuration needed to reproduce the run.
Start with the n8n workflow
The resource hub supplies three n8n workflows, Airtable scripts, a Postman collection and a Power Automate connector starter, plus detailed guides for n8n, Make, Zapier, Airtable and Power Automate. Use the Relay.app migration guide for its discontinued service. Keep secrets in the automation platform's credential store.
FAQ
Common questions
1.Where are the exact request fields?
Use the API documentation and live OpenAPI reference. The public demo has fixed sample inputs; your own templates and artwork use the authenticated API.
Put the guide into practice
Review the workflow and requirements before creating your next output.
Open the API referenceFree plan · no credit card · no watermarks
PSD compatibility reportsSaved projectsAPI with webhooks