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

# Create Application Using Workflow Builder

> Creates a new application from workflow field data and returns the
created application. Submitted values are mapped through the workflow's
field definitions to the application, its business, and its owners.



## OpenAPI

````yaml /openapi.yaml post /api/applications/workflow
openapi: 3.0.3
info:
  title: Lendflow API docs
  description: ''
  version: 1.0.0
servers:
  - url: https://api.lendflow.com
security:
  - default: []
tags:
  - name: Authentication
    description: >-

      Lendflow uses API Bearer Tokens to permit access to our API. You can
      register for a new Lendflow API key on our <a style="color:blue;"
      href="https://app.lendflow.com/login">client portal</a> in less than 60
      seconds. The Bearer Token needs to be included in all API requests made to
      the API Service in the following form: <div
      id="auth-example">Authorization: Bearer [YOUR_TOKEN]</div><div
      id="auth-reminder"><div id="edge-green"></div><div
      id="auth-reminder-text">You must replace [YOUR_TOKEN] with your personal
      API key.</div></div>
  - name: Access Tokens
    description: |-

      Create and manage the personal access tokens used to authenticate API
      requests.
  - name: Workflow Management
    description: |-

      Create applications and manage them through every stage of their workflow,
      from intake through decision.
  - name: Documents
    description: |-

      Upload, retrieve, and manage the files attached to an application.
  - name: Placements
    description: |-

      Submit applications to lenders and manage each placement through its
      lifecycle.
  - name: Offers
    description: |-

      Create and manage offers on an application, from initial terms through
      funding.
  - name: Smartviews
    description: |-

      Save and manage reusable application filters that organize your pipeline.
  - name: Workflow Templates
    description: |-

      Browse the workflow templates available for creating applications.
  - name: Consent Templates
    description: |-

      Manage the consent documents presented to applicants for signature.
  - name: Offer Templates
    description: |-

      Manage the templates that define the structure and fields of your offers.
  - name: Data Orchestration
    description: |-

      Run data orchestration templates against applications and review their
      execution logs.
  - name: Attributes
    description: |-

      Define computed attributes and evaluate them against your applications.
  - name: Scorecards
    description: |-

      Run scorecards and scorecard groups against applications and retrieve
      their results.
  - name: Entity Profiles
    description: |-

      Manage the reusable business and individual profiles shared across
      applications.
  - name: Organization
    description: |-

      Manage the users in your organization.
  - name: Metadata
    description: |-

      Attach custom key-value data to your applications and files.
paths:
  /api/applications/workflow:
    post:
      tags:
        - Workflow Management
      summary: Create Application Using Workflow Builder
      description: |-
        Creates a new application from workflow field data and returns the
        created application. Submitted values are mapped through the workflow's
        field definitions to the application, its business, and its owners.
      parameters: []
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                workflow_template_id:
                  type: string
                  description: Workflow template ID.
                  example: architecto
                client_id:
                  type: string
                  description: >-
                    Client ID. Required for Lendflow users, and ignored for
                    every other user, who always gets their own client. Must
                    match an existing stored value.
                  example: architecto
                prequalification_id:
                  type: string
                  description: Must match an existing stored value.
                  example: null
                client_tracking_token:
                  type: string
                  description: >-
                    Client tracking token. Must not be greater than 50
                    characters.
                  example: 'n'
                tracking_tokens:
                  type: array
                  description: Must not be greater than 255 characters.
                  example:
                    - g
                  items:
                    type: string
                utm_parameters:
                  type: array
                  description: UTM parameters.
                  example: null
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                        description: >-
                          UTM parameter type: utm_campaign, utm_source,
                          utm_medium, utm_term or utm_content.
                        example: utm_content
                        enum:
                          - utm_campaign
                          - utm_source
                          - utm_medium
                          - utm_term
                          - utm_content
                      value:
                        type: string
                        description: UTM parameter value.
                        example: architecto
                move_to_next_stage:
                  type: boolean
                  description: >-
                    Move the application to the next workflow stage, if
                    possible.
                  example: false
                with_validation:
                  type: boolean
                  description: >-
                    Validate application when moving to the next workflow stage.
                    Can only be used with `move_to_next_stage`.
                  example: true
                data_orchestration_template_id:
                  type: string
                  description: >-
                    Data orchestration template ID. Must match an existing
                    stored value.
                  example: null
                bank_statements:
                  type: array
                  description: Must not have more than 10 items.
                  example: null
                  items:
                    type: object
                    properties:
                      file:
                        type: string
                        format: binary
                        description: >-
                          This field is required when
                          <code>bank_statements</code> is present. Must be a
                          file. Must not be greater than 102400 kilobytes.
                      type:
                        type: string
                        description: >-
                          This field is required when
                          <code>bank_statements</code> is present.
                        example: bank_statements_6
                        enum:
                          - bank_statements
                          - bank_statements_1
                          - bank_statements_2
                          - bank_statements_3
                          - bank_statements_4
                          - bank_statements_5
                          - bank_statements_6
                          - bank_statements_7
                          - bank_statements_8
                          - bank_statements_9
                          - bank_statements_10
                          - bank_statements_11
                          - bank_statements_12
                          - personal_bank_statements
                with_underwriting:
                  type: string
                  description: ''
                  example: null
                external_service_logs:
                  type: string
                  description: ''
                  example: null
                note:
                  type: object
                  description: Application note to add.
                  example: null
                  properties:
                    comment:
                      type: string
                      description: Application note content.
                      example: architecto
                    visibility_scope:
                      type: string
                      description: >-
                        Application note visibility scope. get_options returns
                        the valid scopes under application_note_scopes.
                      example: 5
                      enum:
                        - 1
                        - 2
                        - 3
                        - 5
                        - 6
                  nullable: true
                lenient_fields:
                  type: array
                  description: ''
                  example:
                    - affiliated_businesses_phone_numbers
                  items:
                    type: string
                    enum:
                      - accounts_payable_phone_number
                      - affiliated_businesses_phone_numbers
                      - affiliated_individuals_telephone
                      - bonding_agent_telephone
                      - business_phone_numbers
                      - company_officers_phone_number
                      - guarantor_telephone
                      - insurance_telephone
                      - personal_phone_numbers
                      - personal_telephone
                      - trade_references_business_telephone
                    nullable: true
                brand_name_id:
                  type: string
                  description: >-
                    Client brand name to associate with the deal.
                    list_client_brand_names returns the client's brand names
                    with their ids. Must belong to the deal's client. Overrides
                    the workflow template's default brand.
                  example: null
                  nullable: true
                plaid_data:
                  type: object
                  description: ''
                  example: null
                  properties: {}
                plaid:
                  type: object
                  description: ''
                  example: []
                  properties:
                    transactions:
                      type: object
                      description: ''
                      example: null
                      properties: {}
                    asset_report:
                      type: object
                      description: ''
                      example: null
                      properties: {}
              required:
                - workflow_template_id
                - client_id
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                example:
                  data:
                    id: null
                    client_id: null
                    brand_name_id: null
                    workflow_segment: null
                    client_tracking_token: null
                    status: null
                    closing_status_id: null
                    progress: 0
                    use_of_fund_id: null
                    docusign_placeholder_id: null
                    contract_template_id: null
                    consent_template_id: null
                    funds_needed_time_id: null
                    is_business_credit: false
                    is_equipment_rental: false
                    is_data_capture: false
                    is_discovery_complete: null
                    finished_type: null
                    finished_at: null
                    amount_needed: null
                    referrer_url: null
                    source: null
                    underwriter_review_needed: null
                    created_at: null
                    updated_at: null
                    offers_declined_feedback: null
                    offers_declined_at: null
                    has_bank_data: false
                    moneythumb_book: null
                    stage: null
                    is_client_funded: false
                    repayment_percentage: 0
                    score_card_id: null
                    score_card_group_id: null
                    has_insurance: null
                    deal_mode: 1
                    workflow: 1
                    has_death_notification: false
                    tracking_tokens: []
                    priority: null
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        example: null
                        nullable: true
                      client_id:
                        type: string
                        example: null
                        nullable: true
                      brand_name_id:
                        type: string
                        example: null
                        nullable: true
                      workflow_segment:
                        type: string
                        example: null
                        nullable: true
                      client_tracking_token:
                        type: string
                        example: null
                        nullable: true
                      status:
                        type: string
                        example: null
                        nullable: true
                      closing_status_id:
                        type: string
                        example: null
                        nullable: true
                      progress:
                        type: integer
                        example: 0
                      use_of_fund_id:
                        type: string
                        example: null
                        nullable: true
                      docusign_placeholder_id:
                        type: string
                        example: null
                        nullable: true
                      contract_template_id:
                        type: string
                        example: null
                        nullable: true
                      consent_template_id:
                        type: string
                        example: null
                        nullable: true
                      funds_needed_time_id:
                        type: string
                        example: null
                        nullable: true
                      is_business_credit:
                        type: boolean
                        example: false
                      is_equipment_rental:
                        type: boolean
                        example: false
                      is_data_capture:
                        type: boolean
                        example: false
                      is_discovery_complete:
                        type: string
                        example: null
                        nullable: true
                      finished_type:
                        type: string
                        example: null
                        nullable: true
                      finished_at:
                        type: string
                        example: null
                        nullable: true
                      amount_needed:
                        type: string
                        example: null
                        nullable: true
                      referrer_url:
                        type: string
                        example: null
                        nullable: true
                      source:
                        type: string
                        example: null
                        nullable: true
                      underwriter_review_needed:
                        type: string
                        example: null
                        nullable: true
                      created_at:
                        type: string
                        example: null
                        nullable: true
                      updated_at:
                        type: string
                        example: null
                        nullable: true
                      offers_declined_feedback:
                        type: string
                        example: null
                        nullable: true
                      offers_declined_at:
                        type: string
                        example: null
                        nullable: true
                      has_bank_data:
                        type: boolean
                        example: false
                      moneythumb_book:
                        type: string
                        example: null
                        nullable: true
                      stage:
                        type: string
                        example: null
                        nullable: true
                      is_client_funded:
                        type: boolean
                        example: false
                      repayment_percentage:
                        type: integer
                        example: 0
                      score_card_id:
                        type: string
                        example: null
                        nullable: true
                      score_card_group_id:
                        type: string
                        example: null
                        nullable: true
                      has_insurance:
                        type: string
                        example: null
                        nullable: true
                      deal_mode:
                        type: integer
                        example: 1
                      workflow:
                        type: integer
                        example: 1
                      has_death_notification:
                        type: boolean
                        example: false
                      tracking_tokens:
                        type: array
                        example: []
                      priority:
                        type: string
                        example: null
                        nullable: true
components:
  securitySchemes:
    default:
      type: http
      scheme: bearer
      description: >-
        <br>You can register for a new Lendflow API key on our <a
        style="color:blue;" href="https://app.lendflow.com/login">client
        portal</a> in less than 60 seconds. The Bearer Token needs to be
        included in all API requests made to the API Service in the following
        form: <div id="auth-example">Authorization: Bearer
        [YOUR_TOKEN]</div><div id="auth-reminder"><div
        id="edge-green"></div><div id="auth-reminder-text">You must replace
        [YOUR_TOKEN] with your personal API key.</div></div>

````