Generate Widget Session

POSThttps://api.prestatech.com/workflow/sbx/v1/widget-iframe

Start a widget session for an agent. Returns a ready-to-embed iFrame URL and a token you can pass to the SDK. Call this from your backend once per applicant, then embed the widget.

Recent Requests

TimeStatusUser Agent

Make a request to see history.

0 Requests This Month🔑 Log in to see full request history

Body Params

AgentWorkflowIdstringrequired

The Agent ID to run (from the portal).

accountHolderstringrequired

The applicant's name.

vatNumberstring

The applicant's VAT / tax number (optional).

localestring

UI language for the widget.

enitde

Headers

Ocp-Apim-Subscription-Keystringrequired

Your environment's subscription key

Authorizationstringrequired

Bearer access token from the OAuth endpoint.

Responses

Request Example

Examples

curl --request POST \
  --url 'https://api.prestatech.com/workflow/sbx/v1/widget-iframe' \
  --header 'Ocp-Apim-Subscription-Key: YOUR_SUBSCRIPTION_KEY' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "AgentWorkflowId": "your_AgentWorkflowId",
  "accountHolder": "your_accountHolder",
  "vatNumber": "your_vatNumber",
  "locale": "your_locale"
}'

Try It!

Updated July 2026