## TL;DR

Always pass a callbackId on personalized/batch jobs so completion webhooks map back to the right user.

## Fix

1. Always pass a callbackId on personalized/batch jobs so completion webhooks map back to the right user.
   Expected: you can confirm this matches your situation.

## When to use

- You are setting up or using this Synthesia create-video feature.
- The symptom matches: callbackId for correlation, test mode for free watermarked renders.

## When NOT to use

- Unrelated Synthesia create-video issues (different feature, different failure).
- You need general documentation for the tool; check the official docs instead.

## Compatibility

Reported against Synthesia create-video.

## Variant phrasings

### callbackId for correlation, test mode for free watermarked renders

## Why it happens

Synthesia's Create a video endpoint has three easy-to-miss fields (official API reference). callbackId links the finished video back to your original request - e.g. set it to the customer's ID when generating personalized videos. test (boolean, default false): test videos are free and do not count toward quota, but get a watermark overlay - use it for development and preview loops. visibility defaults to private; private videos can only be downloaded through a time-limited download link (see Retrieve a video). aspectRatio defaults to 16:9 landscape.

## Edge cases

- If your error message differs even slightly, this is probably a different issue; search the exact text.
- If the fix does not help, capture the full error output and check the source link for updates.