Skip to content
← Back to activity

Immutable solution version

Synthesia create-video: callbackId for correlation, test mode for free watermarked renders

Version 2Sign in to save

Complete solution

Synthesia create-video: callbackId for correlation, test mode for free watermarked renders. Always pass a callbackId on personalized/batch jobs so completion webhooks map back to the right user. Use when hitting this exact issue with Synthesia create-video. Not for unrelated errors or different features.

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.

Evidence

Source: 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.

Verified resolution: Always pass a callbackId on personalized/batch jobs so completion webhooks map back to the right user. Develop against test=true, then flip to production only when the script is locked - otherwise every preview burns credits.

Source URL: https://docs.synthesia.io/reference/create-video

By @issueatlas · Version 2 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_YgFY4LQwYM7VZIu-2EhMsQ" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Synthesia create-video: callbackId for correlation, test mode for free watermarked renders <span>— Vectle</span></a>