> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Widget URL With Configuration Options

> This endpoint returns a widget URL with configuration options.

This endpoint allows you to get a URL by passing the `widget_type` in the request body along with the desired configuration options. Only set the `use_cases` field if you've opted in to using the feature, in which case setting this field is required. Each URL contains an embedded token that expires after ten minutes or when used, whichever comes first. A fresh URL must be obtained each time a page is loaded or reloaded.

See [Widget Types](/api-reference/sso/v3/reference/widget-urls/widget-types) for supported values.

Options may be tied to a particular `widget_type`. These are described in the [Configuration Options](/api-reference/sso/v3/reference/widget-urls/config-options) section. You may also pass an optional Accept-Language header. Note that this is a POST request, and that JSON data must be used in the request.

<Info>
  Automatic aggregation is triggered when any widget URL retrieved from this endpoint is **loaded** (as opposed to when the request was made), except for the `connect_widget` and `connections_widget`. If you'd like automatic aggregation for the `connect_widget` and `connections_widget`, please reach out to MX.
</Info>

<RequestExample>
  ```shell Request theme={null}
  curl -i -X POST https://int-sso.moneydesktop.com/{client_id}/users/{user_id}/urls.json  \
    -H 'Content-Type: application/vnd.moneydesktop.sso.v3+json' \
    -H 'Accept: application/vnd.moneydesktop.sso.v3+json' \
    -H 'MD-API-KEY: {api_key}' \
    -d '{
          "url": {
            "is_mobile_webview": false,
            "style": {
                "font_name": "Roboto" 
             },
            "type": "connect_widget",
            "use_cases": ["PFM"],
            "ui_message_version": 4
          }
        }'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "url": {
      "url": "https://int-widgets.moneydesktop.com/md/connect/XXXXXX",
      "type": "connect_widget",
      "user_id": "USR-1234"
    }
  }
  ```
</ResponseExample>