n8n-nodes-sudomock

n8n community node for the SudoMock API. Integrate mockup rendering into your n8n workflows for Print-on-Demand automation.

SudoMock | Documentation | API Reference

Features

Account Operations

• Get Account Info: Retrieve account details, subscription plan, and usage statistics

Mockup Management

• Upload PSD: Upload PSD templates from a URL
• List Mockups: List all your uploaded mockup templates with filtering and pagination
• Get Mockup: Get detailed information about a specific mockup template
• Update Mockup: Update the name of a mockup template
• Delete Mockup: Delete a specific mockup template

Rendering

• Render Mockup: Generate mockups by combining templates with your designs

Installation

Via n8n UI

In n8n, go to Settings → Community Nodes → Install and enter:

n8n-nodes-sudomock

Manual Installation

cd ~/.n8n/nodes
npm install n8n-nodes-sudomock

Restart n8n after installation.

Setup

1. Get Your API Key

1. Sign up at SudoMock
2. Go to Dashboard → API Keys
3. Create a new API key (starts with sm_)

2. Add Credentials in n8n

1. Create a new SudoMock node
2. Click on Credentials → Create New
3. Enter your SudoMock API Key
4. Save and test the connection

Operations

Get Account Info

Retrieve your account information, subscription details, and credit usage.

Output:

• Account: UUID, email, name, created date
• Subscription: Plan name, status, billing period
• Usage: Credits used/remaining, billing dates
• API Key: Name, creation date, last used, total requests

Example Output:

{
  "success": true,
  "data": {
    "account": {
      "uuid": "user-123",
      "email": "user@example.com",
      "name": "John Doe"
    },
    "subscription": {
      "plan": { "name": "Pro", "tier": "pro" },
      "status": "active"
    },
    "usage": {
      "credits_used_this_month": 250,
      "credits_limit": 1000,
      "credits_remaining": 750
    }
  }
}

---

Upload PSD

Upload a PSD template from a public URL.

Parameters:

• PSD File URL (required): Public URL to your PSD file (max 300MB)
• Template Name (optional): Custom name for the template (auto-generated if not provided)

Example:

PSD URL: https://storage.example.com/mockup.psd
Name: T-Shirt Mockup Front

Output:

• Mockup UUID (use for rendering)
• Smart object UUIDs and details
• Thumbnail URLs

---

List Mockups

List all your uploaded mockup templates with optional filtering and pagination.

Parameters:

• Return All: Fetch all mockups or limit results
• Limit: Number of results (1-100, default: 20)
• Additional Options:
  • Filter by Name: Exact name match
  • Created After: Date filter
  • Created Before: Date filter
  • Sort By: created_at, updated_at, name
  • Sort Order: asc or desc

Example:

Limit: 20
Sort By: Created At
Sort Order: Descending

Output:
Each mockup as a separate item with full details (UUID, name, smart objects, thumbnails, etc.)

---

Get Mockup

Retrieve detailed information about a specific mockup template.

Parameters:

• Mockup UUID (required): UUID of the mockup to retrieve

Example:

Mockup UUID: c315f78f-d2c7-4541-b240-a9372842de94

Output:
Complete mockup details including all smart objects, thumbnails, and metadata.

---

Update Mockup

Update the name of a mockup template.

Parameters:

• Mockup UUID (required): UUID of the mockup to update
• New Name (required): New name for the template

Example:

Mockup UUID: c315f78f-d2c7-4541-b240-a9372842de94
New Name: Updated T-Shirt Mockup

Output:
Updated mockup details with the new name.

---

Render Mockup

Generate a mockup by filling smart objects with your designs.

Parameters:

• Mockup UUID (required): UUID from Upload PSD response

• Smart Objects (required): One or more smart objects to fill

  • Smart Object UUID
  • Design URL (PNG, JPG, WebP)
  • Fit Mode: fill, contain, or cover (recommended)
  • Additional Options (optional):
    • Rotation: -360 to 360 degrees
    • Color Overlay: Hex color code
    • Color Blend Mode: Various blend modes
    • Brightness: -150 to 150
    • Contrast: -100 to 100
    • Opacity: 0-100

• Export Options (optional):

  • Image Format: WebP (recommended), PNG, or JPEG
  • Image Size: Width in pixels (100-8000)
  • Quality: 1-100 for JPG/WebP
  • Export Label: Custom label for file naming

Example:

Mockup UUID: abc123-def456
Smart Object 1:
  - UUID: so-uuid-001
  - Design URL: https://cdn.example.com/design.png
  - Fit Mode: Cover
  - Brightness: 10
  - Contrast: 5

Export Options:
  - Format: WebP
  - Size: 1920
  - Quality: 95

Output:

{
  "success": true,
  "renderedImageUrl": "https://cdn.sudomock.com/renders/abc123.webp",
  "allRenderedUrls": [
    "https://cdn.sudomock.com/renders/abc123.webp"
  ],
  "data": {
    "print_files": [...]
  }
}

---

Delete Mockup

Delete a specific mockup template.

Parameters:

• Mockup UUID (required): UUID of the mockup to delete

Example:

Mockup UUID: c315f78f-d2c7-4541-b240-a9372842de94

Output:
Deletion confirmation

---

Example Workflows

Ready-to-use n8n workflows are available in the examples/ folder:

1. Complete API Test Workflow

File: examples/complete-test-workflow.json

Tests all 7 operations in sequence:

• Get Account Info → Upload PSD → Get Mockup → List Mockups
• Render Mockup → Update Name → Verify Update → Delete Mockup

Perfect for verifying your setup and understanding the complete workflow.

View Details →

2. Rate Limit Handling Workflow

File: examples/rate-limit-test-workflow.json

Demonstrates proper rate limit error handling with automatic retry logic:

• Detects 429 errors
• Extracts retry-after value
• Waits and automatically retries
• Shows detailed error information

View Details →

3. Sequential Batch Render Workflow

File: examples/batch-render-workflow.json

Demonstrates the power of n8n workflows with sequential batch processing:

• Renders 10 mockups one after another
• Uses different designs for each render
• 2-second delay between renders to avoid rate limits
• Progress tracking and final summary with all rendered URLs

Perfect for understanding batch processing and workflow automation.

View Details →

Quick Start with Examples

1. Import a workflow:

   n8n UI → Workflows → Import from File → Select workflow JSON
   

2. Configure credentials:

   Click any SudoMock node → Credentials → Select your API key
   

3. Execute:

   Click "Execute Workflow" button
   

See examples/README.md for detailed instructions, customization options, and troubleshooting.

---

Usage Examples

Example 1: Complete Mockup Workflow

1. [HTTP Request]
   → Download PSD from URL

2. [SudoMock: Upload PSD]
   → Upload template
   → Extract: mockupUuid, smartObjectUuid

3. [SudoMock: Render Mockup]
   → Use extracted UUIDs
   → Add design URL
   → Get: renderedImageUrl

4. [Etsy/Shopify Node]
   → Create product listing
   → Use rendered mockup image

Example 2: Batch Process Designs

1. [Airtable Trigger]
   → Get list of designs to process

2. [SudoMock: List Mockups]
   → Get available templates

3. [Loop Over Designs]
   → [SudoMock: Render Mockup]
   → Generate mockup for each design

4. [Store Results]
   → Save rendered URLs to database

Example 3: Account Monitoring

1. [Schedule Trigger]
   → Run daily at 9 AM

2. [SudoMock: Get Account Info]
   → Check credit usage

3. [IF Node]
   → If credits < 100

4. [Send Email/Slack]
   → Alert about low credits

Rate Limits

Request Rate Limits

All authenticated users have a base rate limit of 1000 requests per minute with burst capacity of 1500 requests.

Unauthenticated requests (IP-based): 30 requests per minute

Concurrent Request Limits (Plan-Based)

Plan	Concurrent Renders	Concurrent Uploads
Free	1	1
Starter	3	2
Pro	10	5
Scale	25	10

Rate Limit Error Handling

The node automatically detects and handles two types of rate limit errors:

1. Request Rate Limit Exceeded (1000 RPM)

Error Output:

{
  "error": "Rate limit exceeded (1000 requests/minute). Please retry after 42 seconds.",
  "operation": "render",
  "statusCode": 429,
  "retryAfter": 42,
  "errorType": "rate_limit_exceeded",
  "errorDetails": {
    "type": "rate_limit_exceeded",
    "limit": 1000,
    "remaining": 0
  }
}

2. Concurrent Limit Exceeded (Plan-Based)

Error Output:

{
  "error": "Concurrent render limit reached (11/10). Please wait 5 seconds and try again.",
  "operation": "render",
  "statusCode": 429,
  "retryAfter": 5,
  "errorType": "concurrent_limit_exceeded",
  "errorDetails": {
    "type": "concurrent_limit_exceeded",
    "resource": "concurrent-render",
    "limit": 10,
    "current": 11
  }
}

Best Practices

1. Enable "Continue On Fail" in n8n node settings to capture rate limit errors without stopping the workflow
2. Implement retry logic using the retryAfter value from error output
3. Monitor errorType to distinguish between request rate limits and concurrent limits
4. Use n8n's "Wait" node with {{$json.retryAfter}} seconds before retrying

Example: Retry Logic Workflow

[SudoMock Render] (Continue On Fail: ON)
    → [IF: Check statusCode]
        → If 429: [Wait: {{$json.retryAfter}} seconds]
            → [SudoMock Render Again]
        → Else: Continue

Error Handling

All operations support the Continue On Fail option in n8n. When enabled:

• Errors are captured as output items
• Workflow continues to next item
• Error details included in output

Example Error Output:

{
  "error": "Rate limit exceeded. Retry after 42 seconds.",
  "operation": "render"
}

Development

Setup

# Clone repository
git clone https://github.com/sudomock/n8n-nodes-sudomock.git
cd n8n-nodes-sudomock

# Install dependencies
pnpm install

# Build
pnpm build

# Development (watch mode)
pnpm dev

Testing Locally

# Link package globally
npm link

# Link in n8n's custom nodes
cd ~/.n8n/custom
npm link n8n-nodes-sudomock

# Start n8n
n8n start

Access n8n at http://localhost:5678 and search for "SudoMock" in the nodes panel.

Build Commands

# Build TypeScript and icons
pnpm build

# Format code
pnpm format

# Lint code
pnpm lint

# Fix linting issues
pnpm lintfix

Resources

• SudoMock Website
• API Documentation
• n8n Documentation
• Report Issues

License

MIT

Support

• Email: hello@sudomock.com
• Documentation: https://sudomock.com/docs
• Community: https://community.n8n.io

---

Made with ❤️ for the n8n community