Build booking widget iframe HTML

post

https://api.duda.co/api/sites/multiscreen/{site_name}/booking/widget-embed

Returns iframe markup for embedding the published site's booking widget. Requires a published site, a BOOKING_WIDGET page, and valid event identifiers.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

site_name

string

required

The site's unique name (its ID), returned when the site is created.

Body Params

appointment_type_ids

array of strings

required

Appointment type identifiers to show in the widget; each must exist for the site.

appointment_type_ids*

choose_appointment_stage_config

object

Choose appointment stage configuration (titles and visibility)

choose_staff_member_stage_config

object

Choose staff stage config

design_config

object

Colors and text styles of the booking flow. Every field is optional and overrides the value it maps to; omitted fields keep whatever design_style resolves to, which is the site theme unless design_style asks for another palette. Text style defaults: titles the site theme's H5 style, subtitles its paragraph style, paragraphs its default text style.

design_style

string

enum

Visual design style for the booking flow

Allowed:

lang

string

Published site language (locale code), e.g. en, de, pt-br. Allowed values follow the Partner API locale list: https://developer.duda.co/reference/getting-started-with-the-duda-api

show_free_price

boolean

Whether to show free price labels

Responses

401

Unauthorized request - missing or invalid credentials

429

Rate limit exceeded - please refer to api documentation for limits

200OK

400Non-OK response from the server