​

Zapier Integration

​

Example workflow

​

Step 1: Create a new Zap

1. Log in to zapier.com
2. Click Create Zap
3. Choose your trigger app (WooCommerce, Shopify, or any app that provides orders)

​

Step 2: Configure the trigger

• App: WooCommerce
• Event: New Order
• Account: Connect your WooCommerce store
• Test: Fetch a sample order to use in the next steps

​

Step 3: Add PixCraft API action

1. Click + to add a new step
2. Choose Webhooks by Zapier
3. Select Custom Request
4. Configure:

​

Request body

{
  "image_url": "{{order_item_image_url}}",
  "niche": "mosaics",
  "width_cm": 100,
  "height_cm": 100,
  "max_colors": 8
}

​

Step 4: Generate PDF (optional)

• Save it to Google Drive or Dropbox
• Attach it to an email

​

Step 5: Email the result

1. Choose Gmail or Email by Zapier
2. Set the recipient to the customer’s email from the order
3. Include pattern details from Step 3 in the email body:

Your pattern has been generated!

Grid: {{dimensions.cols}} × {{dimensions.rows}}
Total units: {{dimensions.total_units}}
Colors used: {{materials.length}}

Materials needed:
{{#each materials}}
- {{color_name}}: {{quantity}} units ({{percentage}}%)
{{/each}}

​

Alternative: Use Code by Zapier

const response = await fetch('https://www.pixcraft.es/api/v1/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer ' + inputData.apiKey,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    image_url: inputData.imageUrl,
    niche: inputData.niche || 'mosaics',
    width_cm: parseInt(inputData.width) || 100,
    height_cm: parseInt(inputData.height) || 100,
  }),
});

const data = await response.json();

output = [{
  totalUnits: data.dimensions.total_units,
  colorsUsed: data.materials.length,
  materialsSummary: data.materials.map(m => `${m.color_name}: ${m.quantity}`).join('\n'),
}];

​

Tips

• Check usage before processing: Call GET /api/v1/usage at the start of your Zap to verify you have credits remaining
• Validate first: Use POST /api/v1/validate to check image quality before spending a generation credit
• Handle errors: Add a Zapier Paths step to handle API errors gracefully (send a notification instead of failing silently)