Integrations

Embeddable studio

The same design editor used at /studio can be mounted on your own site as an iframe, so your end-users can create and render templates without ever visiting BuildOnce directly. Configure it from Embed in the dashboard.

An embed has no session cookie or API key of its own. Instead, your backend requests a short-lived embed session token for the current end-user, and hands that to the iframe — see API reference.
Integrations

Configuration

Each embed has its own configuration, independent of the dashboard studio:

ParamTypeNotes
allowedDomainsstring[]Hostnames allowed to load the embed. Empty allows any origin.
downloadsEnabledbooleanGrants render:write on sessions for this embed.
assetPickerEnabledbooleanGrants asset:read and asset:write on sessions for this embed.
smartResizeEnabledbooleanToggles the editor's smart-resize UI.
multiTenantEnabledbooleanWhen on, each end-user (by userId) sees only their own templates, not the whole workspace's.
webhooksEnabled / webhookUrlboolean / stringNotifies your backend on template create/update — see below.
brandTitle / brandIconUrl / brandAccentColorstringCosmetic branding shown inside the embedded editor.
Integrations

Webhooks

When webhooksEnabled is on, BuildOnce sends an HTTP POST to your webhookUrl whenever a template is created or updated through the embed:

ParamTypeNotes
template.createeventFired after a template is created via the embed studio.
template.updateeventFired after a template draft is saved via the embed studio.