Create Brand Kit
Creates a brand kit by importing brand assets from a public website, including logos, colors and font files found on the site. By calling this endpoint you confirm you have the rights and licenses necessary to upload, store and use those assets in HeyGen.
The kit is assembled in the background: the returned brand_kit_id is usable immediately, but poll GET /v3/brand-kits/ every 2 to 5 seconds until its status is ‘completed’ before relying on its colors, logos or fonts. A website import usually settles in under two minutes.
Send an Idempotency-Key header to make retries safe: without one, a retried request starts a second import of the same site.
Authorizations
HeyGen API key. Obtain from your HeyGen dashboard.
Headers
Optional client-supplied key for safely retrying mutations. Subsequent calls within 24 hours that share this key replay the original response — even if the request body differs slightly (a warning is logged). A retry that arrives while the original is still in flight gets a 409 request_in_progress. Keys must be 1–255 characters from [A-Za-z0-9_:.-]; a UUID is a safe default. Scope is per-endpoint and per-resource: the same key on a different route or path parameter is independent.
1 - 255^[A-Za-z0-9_\-:.]{1,255}$Body
Request body for POST /v3/brand-kits.
Public website URL to build the brand kit from. HeyGen visits the site and imports the brand assets it finds there, including logos, colors and font files. By calling this endpoint you confirm you have the rights and licenses necessary to upload, store and use those assets in HeyGen.
2048Name for the brand kit, up to 256 characters. Defaults to the brand name detected on the site, or its domain.
256Response
Created.
Response for POST /v3/brand-kits.

