Widgets

MX Widgets APIs issue short-lived SSO URLs so you can load MoneyMap-style PFM widgets (e.g. Mini Budgets) in a webview or iframe.

Supported APIs: MoneyMap (widget collection), SSO API (single sign-on and widget URL provisioning—required for Nexus and MoneyMap integrations per MX overview).

For embed and session semantics, see MX Documentation.

End-user benefits

• Access personal finance management tools and widgets inside your app shell.
• SSO-driven widget launch without long-lived embedded credentials.

Integration capabilities

• Exchange an access token for a short-lived redirect URL with embedded session token.
• Use ext_host, correlationId, and Accept: application/vnd.moneydesktop.sso.v3+xml (or negotiated SSO format) per documentation/mx-services.yaml.

Required headers

Header	Description
Authorization	Bearer token (OAuth2 authentication)
ext_host	Target MX host for request routing
correlationId	UUID for request tracing
Accept	Required; typically application/vnd.moneydesktop.sso.v3+xml for widget URL response

Error codes

HTTP Status Code	Message
400	Bad Request. Typical JSON fields: error, message, optional errors[]
401	Unauthorized. Typical JSON fields: error, message
404	Not Found — user or widget resource not available. Typical JSON fields: error, message

Endpoints

Get MX Widget URL

Retrieves a time-limited, single sign-on (SSO) URL to render the