Create or update widget embed configuration

post

https://be.skipcalls.com/agents/{id}/embed

Creates or updates the widget config for embedding this agent on a website as a voice button. Requires at least one allowed domain (exact "example.com" or wildcard "*.example.com"). Embed key is generated on first create and preserved on updates. Customize position, autoConnect, primaryColor, callButtonText.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

Body Params

allowedDomains

array of strings

required

List of allowed domains for widget embedding

allowedDomains*

voiceChatEnabled

boolean

Enable the voice widget for this embed key

textChatEnabled

boolean

Enable the text chat widget for this embed key

position

string

enum

Widget position on the page

Allowed:

autoConnect

boolean

Auto-connect to call when widget loads

primaryColor

string

Primary color for the widget (hex format)

callButtonText

string

Text displayed on the call button

mode

string

enum

Widget mode

Allowed:

greeting

string

Greeting headline in idle state

subtitle

string

Subtitle text below greeting

borderRadius

string

Widget border radius

showBorder

boolean

Show widget border

showBranding

boolean

Show "Powered by" branding

size

string

enum

Widget size preset

Allowed:

backgroundColor

string

Widget background color (hex format)

fontFamily

string

Font family for widget text

iconUrl

string

Custom icon/avatar URL

textColor

string

Text color on the call button

Response

200Widget configuration created/updated successfully