Image Uploads

Upload images to use in your email templates. Templated stores images in cloud storage and serves them via CDN for fast delivery.

Upload an image

curl -b cookies.txt -X POST \
  https://app.templated.email/api/accounts/{slug}/images \
  -F "file=@/path/to/image.png"

Returns the uploaded image metadata including the CDN URL you can use in templates.

Supported formats

List uploaded images

curl -b cookies.txt \
  https://app.templated.email/api/accounts/{slug}/images

Unsplash integration

Search and use royalty-free photos from Unsplash directly:

Search photos

curl -b cookies.txt \
  "https://app.templated.email/api/accounts/{slug}/integrations/unsplash/search?query=office+workspace"

Download a photo

curl -b cookies.txt -X POST \
  https://app.templated.email/api/accounts/{slug}/integrations/unsplash/download \
  -H "Content-Type: application/json" \
  -d '{ "photoId": "unsplash-photo-id" }'

This triggers the Unsplash download (required by their API terms) and returns a URL you can use in templates.

Best practices for email images

1. Optimize file size — Large images slow down email load times. Aim for under 200 KB per image.
2. Use appropriate dimensions — Email max width is typically 600px. Don't upload 4000px images.
3. Always include alt text — Set alt text in your template for accessibility and image-blocking email clients.
4. Use CDN URLs — Always use the returned CDN URL, not the upload URL.

Next steps

• Create templates using uploaded images
• Test endpoints in the API Reference