---
title: "Create a user management session"
method: POST
path: "/v3/aggregation/user-management-sessions"
tags: ["User management sessions"]
---

# Create a user management session

`POST /v3/aggregation/user-management-sessions`

User management sessions are front-end sessions that allow your users to resolve synchronization issues or add new items for the authenticated user

## Request body

- CreateUserManagementSession
  - `callback_url` string, url — Optional callback URL for redirecting the user at the exit of the user management session
  - `context` string — Optional context string to append to the callback URL when exiting the user management session. It can contain up to 100 alphanumeric characters, including the hyphen (-).
  - `account_types` 'payment' | 'all' — Minimum account types required. We suggest `payment` to ensure the best user experience
  - `user_email` string, email — Mandatory, except in the case of temporary bank synchronization
  - `country_code` 'FR' | 'ES' | 'IT' | 'PT' | 'DE' | 'BE' | 'NL' | 'LU' | 'PL' | 'HU' | 'IE' | 'MT' | 'CZ' | 'NO' | 'BG' | 'SE' | 'DK' | 'AT' | 'SK' | 'FI' | 'GB' | 'GR' | 'EE' | 'IS' | 'CY' | 'HR' | 'LV' | 'RO' — On the displayed providers list, the country selector will default to the country parameter if provided. If you customize the highlighted banks on the dashboard, this parameter will be disabled.
  - `capabilities` string[] — Filter the provider capabilities you need. When multiple values are specified, they are combined using an `AND` operation
  - `allow_account_selection` boolean — Allow or disallow the selection of the accounts
  - `show_add_item_button` boolean — Indicates whether the button for adding an item should be rendered in the UI.

## Response `201`

User management session created

- UserManagementSession — Create user management sessions to make your user fix or add new bank connections
  - `id` string, required — User management session identifier
  - `url` string, url, required — User management session web funnel URL

## Other responses

- `400` — Error 400
- `401` — Error 401

---

[API](https://skmtc.dev/bridgeapi/apis/bridge-api.md) · [All operations](https://skmtc.dev/bridgeapi/apis/bridge-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bridgeapi/bridge-api/revisions/9b9ad8010fd5/schema)