API & SDK

One request, one video

Send a template and its data to the API, and get the finished video or image back. A webhook tells your app when it’s done.

Node.jsPythonPHPRubycURL
await fetch('https://api.creatomate.com/v2/renders', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    template_id: 'YOUR_TEMPLATE_ID',
    modifications: {
      'Title': "Maya's year on the rails",
      'Stat-1-Value': '3,127',
      'Stat-2-Value': '26',
    },
    webhook_url: 'https://your-app.com/video-ready',
  }),
});
Maya's year in review videoSam's year in review videoLena's year in review video
MMaya
SSam
LLena
Step 1

Start with a design

Make a video in the template editor, or pick a ready-made one. Then give each part that should change a name, like a title or a number.

Step 2

Send a request

Your app sends the template's ID and a value for each named part. The editor writes this request for you, in the language you use.

POST /v2/renders
{
  "template_id": "YOUR_TEMPLATE_ID",1
  "modifications": {2
    "Title": "Maya's year on the rails",
    "Stat-1-Value": "3,127",
    "Stat-2-Value": "26",
    "Stat-3-Value": "4,380"
  },
  "webhook_url": "https://your-app.com/video-ready"3
}
  1. 1The template to use, by its ID.
  2. 2The content for this video, one value for each named part.
  3. 3Where to let your app know when the video is done.
Step 3

Get your video

Creatomate makes the video and calls your webhook with a link to the finished file, ready to show in your app, send or post.

POST your-app.com/video-ready
{
  "id": "a862048b-…",
  "status": "succeeded",
  "url": "https://cdn.creatomate.com/renders/a862….mp4",
  "output_format": "mp4",
  "duration": 21.5
}
Maya's finished video
MMaya's video

Or build the whole video in code

No template needed. RenderScript describes a video in JSON: every element, its timing and its animation. Your code can put a whole video together on the fly, like a scene for every listing in a list.

What people build with it

If your app has the content, it can have the video. Each of these starts from a ready-made template.

A before and after video
Before and after

A reveal for every finished project.

A vertical product collection
Product collections

A shoppable video from any list of products.

A photo slideshow
Photo slideshows

A slideshow from the photos your users upload.

A weather update
Weather updates

A forecast for every city, every morning.

A podcast clip
Podcast clips

A shareable clip from every episode.

A vertical quiz
Quizzes

A new quiz from every question set.

A social post image
Social images

A post image for every new article.

A text story
Text stories

A short video from any piece of text.

Good to know

Which languages can I use?

Any language that can send an HTTP request. The docs have examples in cURL, Node.js, PHP, Python, Ruby, C#, Go and Java.

What do I get back?

A link to the finished file: an MP4 for a video, or a JPG, PNG or GIF for an image.

Do I need a webhook?

No. It's the easiest way to hear when a video is done, but you can also check its status yourself.

What does it cost?

Each video uses credits from your plan. See pricing for what a video costs.

Can I make images too?

Yes. The same request with an image template returns an image.

Where do I start?

Read API automation in the docs, from your API key to the first video.

Ready to make your first API call?

Start for free →
  • Every feature included
  • 50 free credits
  • No credit card required