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

# Create a reconnect session

> Create a new connect session to reconnect to a specific integration. The token is used like a standard connect session.
Only connections created with a connect session are compatible with this endpoint.
Use this method when a user needs to input new credentials or to manually refresh token.
The connection keeps its connection ID. When the user authorizes, the connection's tags are replaced by the ones built from `tags` and `end_user`. If that leaves no tags, for example when neither is passed or `tags` is `{}`, the connection keeps its existing tags.


> [!NOTE]
>
> Requires an API key with the `environment:connect_sessions:write` scope. [Learn more about API key scopes](https://nango.dev/docs/reference/backend/http-api/api-keys.md#scopes).


## OpenAPI

````yaml POST /connect/sessions/reconnect
openapi: 3.1.0
info:
  title: Nango API
  description: Nango API specs used to authorize & sync data with external APIs.
  version: 1.0.0
servers:
  - url: https://api.nango.dev
    description: Production server
  - url: http://localhost:3003
    description: Local server
security:
  - bearerAuth: []
externalDocs:
  url: https://nango.dev/docs/reference/backend/http-api/authentication
paths:
  /connect/sessions/reconnect:
    post:
      summary: Reconnect with connect session
      description: >
        Create a new connect session to reconnect to a specific integration. The
        token is used like a standard connect session.

        Only connections created with a connect session are compatible with this
        endpoint.

        Use this method when a user needs to input new credentials or to
        manually refresh token.

        The connection keeps its connection ID. When the user authorizes, the
        connection's tags are replaced by the ones built from `tags` and
        `end_user`. If that leaves no tags, for example when neither is passed
        or `tags` is `{}`, the connection keeps its existing tags.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConnectSessionReconnectInput'
      responses:
        '201':
          description: Successfully created a connect session
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                properties:
                  data:
                    $ref: '#/components/schemas/ConnectSession'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    ConnectSessionReconnectInput:
      type: object
      required:
        - connection_id
        - integration_id
      properties:
        connection_id:
          type: string
        integration_id:
          type: string
        tags: 086add91-089c-4e6d-b928-2ad9ef71c374
        end_user: 8009b627-b8f3-4f62-b484-a6b0c1ace15c
        organization: bb189c00-675c-4f34-8766-7b9f946dadc6
        integrations_config_defaults: 9925da91-d9c6-4adb-bc17-ab9bbd3df707
        overrides: af7945eb-f89f-42c4-976e-ace08c7e7d12
        webhook_url_override: 2cce75c8-d94f-42d6-985c-895344c45e0a
    ConnectSession:
      type: object
      required:
        - token
        - expires_at
      properties:
        token:
          type: string
          description: The connect session token
        connect_link:
          type: string
          description: >-
            The URL to directly connect the user to the integration. This can be
            used as a magic link.
        expires_at:
          type: string
          description: When the token expires
          format: date-time
    StdError:
      type: object
      additionalProperties: false
      properties:
        error:
          type: object
          additionalProperties: false
          required:
            - code
          properties:
            code:
              type: string
            message:
              type: string
            errors:
              type: array
              items:
                type: object
  responses:
    BadRequest:
      description: Bad request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/StdError'
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/StdError'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        An Environment API key from your Nango environment, or an Account API
        key for account-level endpoints.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.