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

# Returns the add account widget's URL



## OpenAPI

````yaml /openapi-v2.json post /api/v2/account/add/lite
openapi: 3.1.0
info:
  title: LedgerSync V2 API
  version: '2.0'
servers:
  - url: https://ledgersyncappv2.com
    description: Production
  - url: https://staging.ledgersyncappv2.com
    description: Sandbox
security: []
tags:
  - name: account-api
    description: Account REST APIs
  - name: password-api
    description: Password REST APIs
  - name: transaction-api
    description: Transaction REST APIs
  - name: phone-verification-api
    description: Phone Verification REST APIs
  - name: employee-api
    description: Employee REST APIs
  - name: client-api
    description: Client REST APIs
  - name: check-api
    description: Check REST APIs
  - name: accounting-ai-api
    description: AI rule suggestion endpoints for external accounting integrations
  - name: institution-api
    description: Institution REST APIs
  - name: statement-api
    description: Statement REST APIs
  - name: authentication-api
    description: Auth REST APIs
paths:
  /api/v2/account/add/lite:
    post:
      tags:
        - account-api
      summary: Returns the add account widget's URL
      operationId: addAccountLite
      parameters:
        - name: Auth-Token
          in: header
          description: Authentication token provided during the authentication process
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AddAccountRequest'
        required: true
      responses:
        '200':
          description: >-
            Returns the add account URL widget to be invoked by the client


            Set the optional **source** field to **MX** to connect a bank via MX
            (for banks Finicity does not support); omit it (or use FINICITY) for
            the default Finicity flow. When **source=MX**, widgetUrl is an MX
            Connect URL (moneydesktop.com) loaded with the MX Connect widget
            instead of the Finicity SDK; omit institutionId to let the user
            search for their bank in the widget.


            Call */api/v2/institutions/provider-options* first if you do not
            already know which provider covers the bank.


            When the call succeed, returning code 200, grab the content of
            widgetUrl and make a call to this url
          content:
            '*/*':
              schema:
                type: string
        '401':
          description: Unauthorized. Bad credentials or the authentication system is down
          content:
            '*/*':
              schema:
                type: string
        '422':
          description: >-
            The requested **source** has no connect widget (only FINICITY and MX
            do)
          content:
            '*/*':
              schema:
                type: string
components:
  schemas:
    AddAccountRequest:
      type: object
      properties:
        username:
          type: string
        redirectUri:
          type: string
        institutionId:
          type: string
        source:
          type: string
          description: >-
            Bank-data provider: FINICITY (default) or MX. Omit for Finicity.
            Applies to both /api/v2/account/add and /api/v2/account/add/lite.
            Use /api/v2/institutions/provider-options to find which providers
            cover a given bank.
          enum:
            - DEFAULT
            - FINICITY
            - FDE
            - MX

````

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