---
title: "POST /nango/session"
method: POST
path: "/nango/session"
tags: ["Nango"]
---

# POST /nango/session

`POST /nango/session`

## Request body

- CreateNangoSessionRequest — Request body for creating a Nango session with optional scope selection
  - `connector_auth_method_id` string, uuid, required
  - `selected_scope_ids` ConnectorAuthMethodScopeId[], nullable — Specific scope IDs to use. If not provided, defaults to required + recommended scopes. If the auth method has no scopes in the database, Nango's default scopes are used.

## Response `200`

Nango connect session created successfully

- object — A Nango connect session for the frontend SDK
  - `expires_at` string, date-time, required
  - `token` string, required

## Other responses

- `400` — Bad request - auth method not found or not OAuth
- `500` — Failed to create Nango session

## Changes

- **2026-01-12** `5985f2143fa5` — 3 breaking, 1 warning
  - the request property `connector_auth_method_id` became not nullable
  - the request property `connector_auth_method_id` became required
  - the `connector_auth_method_id` request property type/format changed from ``/`` to `string`/`uuid`
  - removed `#/components/schemas/ConnectorAuthMethodId` from the `connector_auth_method_id` request property `allOf` list
- **2026-01-12** `f626a7b6587a` — 1 breaking, 1 info
  - added required request body
  - added the non-success response with the status `400`

[Change history](https://skmtc.dev/structifyai/apis/structify/changes/nango/session/post.md)

---

[API](https://skmtc.dev/structifyai/apis/structify.md) · [All operations](https://skmtc.dev/structifyai/apis/structify/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/structifyai/structify/revisions/1364930b6980/schema)