Zapier Integration

Connect Canvelete with 5,000+ apps using Zapier.

Setup

1. Create new Zap in Zapier dashboard
2. Configure trigger (select app and event)
3. Add action: Webhooks by Zapier
4. Select method: POST
5. Configure webhook

Configuration

URL

https://api.canvelete.com/api/v1/render

Headers

{
  "Authorization": "Bearer cvt_YOUR_API_KEY",
  "Content-Type": "application/json"
}

Body (Data)

{
  "designId": "YOUR_DESIGN_ID",
  "format": "png",
  "quality": 90,
  "dynamicElements": {
    "title": "{{trigger.title}}",
    "description": "{{trigger.description}}"
  }
}

Example: Google Sheets → Image

1. Trigger: New row in Google Sheets
2. Action: Webhook POST to Canvelete
3. Map fields:
   • {{Row.Product Name}} → dynamicElements.product_name.text
   • {{Row.Image URL}} → dynamicElements.product_image.src

Variable Mapping

Map Zapier trigger data to Canvelete dynamic elements:

Common Workflows

Form Submission → Certificate

Trigger: Typeform response
Action: Generate certificate with form data

CRM Update → Social Card

Trigger: HubSpot contact created
Action: Generate personalized social media card

E-commerce → Product Card

Trigger: Shopify new product
Action: Generate product marketing image

Error Handling

Configure error handling in Zapier:

1. Add Filter step to validate data
2. Add Paths for conditional logic
3. Add Error Handler to catch failures
4. Enable Auto-Replay for transient errors

Accessing Image URL

After successful render, access the image URL:

{{data.data.imageUrl}}

Use this in subsequent actions (email, social post, storage, etc.).

Rate Limits

Zapier respects your Canvelete API rate limits. Consider:

• Using Delay actions for high-volume Zaps
• Enabling caching with "cache": true
• Batching requests if possible

Troubleshooting

Authentication Failed (401)

• Verify API key is correct
• Ensure Bearer prefix is included
• Check API key hasn't expired

Design Not Found (404)

• Confirm design ID exists
• Verify design isn't archived
• Check design permissions

Invalid Dynamic Elements

• Verify element IDs match design
• Check data types (text vs. image)
• Ensure image URLs are accessible

Best Practices

1. Test with sample data before enabling Zap
2. Use filters to avoid unnecessary API calls
3. Enable caching for repeated renders
4. Set up error notifications for monitoring
5. Store API keys in Zapier's secure storage