DUduda
Native booking widget embed api

Build booking widget iframe HTML

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

post/api/sites/multiscreen/{site_name}/booking/widget-embed

Request

  • Base URL
    https://api.duda.co
  • URL
    https://api.duda.co/api/sites/multiscreen/{site_name}/booking/widget-embed
  • Auth
    HTTP basic

Path parameters

site_namestring required

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

Request body

appointment_type_idsstring[] required

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

design_style'site-theme' | 'basic'

Visual design style for the booking flow

langstring

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_priceboolean

Whether to show free price labels

Example request

{
  "design_config": {
    "background_color": "#FFFFFF",
    "paragraphs": {
      "font": "Roboto",
      "font_size": "32px"
    },
    "primary_color": "#292929",
    "secondary_color": "#EDEFF1",
    "subtitles": {
      "font": "Roboto",
      "font_size": "32px"
    },
    "titles": {
      "font": "Roboto",
      "font_size": "32px"
    }
  }
}

Response

OK

iframe_htmlstring

Ready-to-use iframe HTML pointing at the published site's booking widget

Changes

No recorded changes to this operation across all 1 revision of this API.