Skip to main content
POST
Create a new widget studio

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Represents the Widget Studio entity containing metadata and configurations.

elements
enum<string>[]

List of element types used in the widget studio.

Available options:
BOX,
BUTTON,
BUTTON_V2,
CHECKBOX,
CLOSE,
COPY,
COUNTDOWN,
COUNTDOWN_V2,
COUNTDOWN_PROGRESS_BAR,
COUNTDOWN_V2_PROGRESS_BAR,
DATE,
FORM_ERROR_MESSAGE,
GROUP,
HEADING,
HIDDEN_INPUT,
HTML,
IFRAME,
IMAGE,
INPUT,
LINK,
SCROLLING_TEXT,
MULTI_STEP_FORM,
PRODUCT_RECO,
PROGRESS_BAR,
RADIO_BUTTON,
SELECT,
SHAPE,
SLIDER,
STEP_PROGRESS_BAR,
TEXT,
TEXTAREA,
TIME,
TOOLTIP,
TOGGLE,
VIDEO,
QR_CODE,
RANGE_INPUT,
SPIN_WHEEL,
SCALE,
SCRATCH_CARD,
NPS,
MULTI_CHOICE,
SHORT_TEXT,
LONG_TEXT
eventActions
enum<string>[]

List of event actions that can be triggered within the widget studio.

Available options:
SET_LOCAL_STORAGE,
SET_SESSION_STORAGE,
SET_COOKIES,
SHOW_ELEMENT,
HIDE_ELEMENT,
SET_STEP,
CLICK_ON_ELEMENT,
FORM_DISABLE,
FORM_ENABLE,
JAVASCRIPT,
PROCESS_CONVERSION,
CANCEL_CONVERSION,
SET_CUSTOM_DATA,
TRIGGER_EVENT,
SET_PROGRESS,
SEND_DATA,
RUN_ROTATION_SPIN_WHEEL,
SET_LOCALE,
URL_REDIRECT
eventConditions
enum<string>[]

List of event conditions that determine widget studio behavior.

Available options:
BEFORE_DISPLAY,
AFTER_DISPLAY,
ON_COUNTDOWN_END,
IS_MOBILE,
IS_NOT_MOBILE,
IS_TABLET,
IS_NOT_TABLET,
IS_DESKTOP,
IS_NOT_DESKTOP,
FORM_ITEM_VALUE,
BY_CUSTOM_DATA,
ON_CLICK,
ON_SUCCESS,
ON_ERROR,
REVEALED_SCRATCH_CARD,
ON_SPIN_WHEEL_TURNED,
WIN_SLICE_VALUE,
ON_TIMER_END,
VISITOR_BROWSER_LANGUAGE,
URL_CONTAINS,
URL_REGEX,
ON_VIDEO_END
fonts
Widget font (variant 1) · object[]

List of custom fonts used within the widget studio.

isLegacy
boolean

Indicate if the widget is part of a legacy system

screens
Screen · object[]

List of screens that are part of this widget studio configuration.

translation
Translation · object

Translation settings for the widget studio.

version
number<double>

Version of the widget, precision = 5, scale = 2.

widgetEditorTemplate
string

Serialized JSON representation of the widget configuration used in the editor.

Response

Created

Represents the Widget Studio entity containing metadata and configurations.

dateCreated
string<date-time>
read-only

Date the widget studio object was created.

dateModified
string<date-time>
read-only

Date the widget studio object was last modified.

elements
enum<string>[]

List of element types used in the widget studio.

Available options:
BOX,
BUTTON,
BUTTON_V2,
CHECKBOX,
CLOSE,
COPY,
COUNTDOWN,
COUNTDOWN_V2,
COUNTDOWN_PROGRESS_BAR,
COUNTDOWN_V2_PROGRESS_BAR,
DATE,
FORM_ERROR_MESSAGE,
GROUP,
HEADING,
HIDDEN_INPUT,
HTML,
IFRAME,
IMAGE,
INPUT,
LINK,
SCROLLING_TEXT,
MULTI_STEP_FORM,
PRODUCT_RECO,
PROGRESS_BAR,
RADIO_BUTTON,
SELECT,
SHAPE,
SLIDER,
STEP_PROGRESS_BAR,
TEXT,
TEXTAREA,
TIME,
TOOLTIP,
TOGGLE,
VIDEO,
QR_CODE,
RANGE_INPUT,
SPIN_WHEEL,
SCALE,
SCRATCH_CARD,
NPS,
MULTI_CHOICE,
SHORT_TEXT,
LONG_TEXT
eventActions
enum<string>[]

List of event actions that can be triggered within the widget studio.

Available options:
SET_LOCAL_STORAGE,
SET_SESSION_STORAGE,
SET_COOKIES,
SHOW_ELEMENT,
HIDE_ELEMENT,
SET_STEP,
CLICK_ON_ELEMENT,
FORM_DISABLE,
FORM_ENABLE,
JAVASCRIPT,
PROCESS_CONVERSION,
CANCEL_CONVERSION,
SET_CUSTOM_DATA,
TRIGGER_EVENT,
SET_PROGRESS,
SEND_DATA,
RUN_ROTATION_SPIN_WHEEL,
SET_LOCALE,
URL_REDIRECT
eventConditions
enum<string>[]

List of event conditions that determine widget studio behavior.

Available options:
BEFORE_DISPLAY,
AFTER_DISPLAY,
ON_COUNTDOWN_END,
IS_MOBILE,
IS_NOT_MOBILE,
IS_TABLET,
IS_NOT_TABLET,
IS_DESKTOP,
IS_NOT_DESKTOP,
FORM_ITEM_VALUE,
BY_CUSTOM_DATA,
ON_CLICK,
ON_SUCCESS,
ON_ERROR,
REVEALED_SCRATCH_CARD,
ON_SPIN_WHEEL_TURNED,
WIN_SLICE_VALUE,
ON_TIMER_END,
VISITOR_BROWSER_LANGUAGE,
URL_CONTAINS,
URL_REGEX,
ON_VIDEO_END
fonts
Widget font (variant 1) · object[]

List of custom fonts used within the widget studio.

isLegacy
boolean

Indicate if the widget is part of a legacy system

screens
Screen · object[]

List of screens that are part of this widget studio configuration.

translation
Translation · object

Translation settings for the widget studio.

version
number<double>

Version of the widget, precision = 5, scale = 2.

widgetEditorTemplate
string

Serialized JSON representation of the widget configuration used in the editor.

widgetId
integer<int64>
read-only

Id of the widget.