> ## 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 Lender Placement

> Submits an application to a funder, creating a placement that is
delivered through the funder's configured integration method.



## OpenAPI

````yaml /openapi.yaml post /api/applications/{application_id}/placements
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/{application_id}/placements:
    parameters:
      - in: path
        name: application_id
        description: The ID of the application.
        example: architecto
        required: true
        schema:
          type: string
    post:
      tags:
        - Placements
      summary: Create Lender Placement
      description: |-
        Submits an application to a funder, creating a placement that is
        delivered through the funder's configured integration method.
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                method:
                  type: integer
                  description: >-
                    Way to place an application to a funder. 1 (Api), 2 (Email),
                    3 (Manual), 4 (Lendflow). This field is optional. If field
                    is not present use the funder's primary method.
                  example: 1
                  enum:
                    - 1
                    - 2
                    - 3
                    - 4
                funder_id:
                  type: string
                  description: >-
                    Funder identifier. This field is required when
                    <code>offer_template_id</code> is not present. Must match an
                    existing stored value.
                  example: null
                emails:
                  type: array
                  description: Must be a valid email address.
                  example:
                    - gbailey@example.net
                  items:
                    type: string
                email_body:
                  type: string
                  description: >-
                    This field is required when <code>method</code> is
                    <code>2</code>.
                  example: null
                attachments:
                  type: object
                  description: File IDs for application files uploaded.
                  example: null
                  properties: {}
                  nullable: true
                stage_id:
                  type: string
                  description: Stage identifier. Must be a valid UUID.
                  example: 977e5426-8d13-3824-86aa-b092f8ae52c5
                product_id:
                  type: string
                  description: >-
                    Product Identifier. This field is required when
                    <code>offer_template_id</code> is not present. Must match an
                    existing stored value.
                  example: null
                offer_template_id:
                  type: string
                  description: Must match an existing stored value.
                  example: null
                  nullable: true
                destination:
                  type: string
                  description: ''
                  example: null
                url:
                  type: string
                  description: Must be a valid URL.
                  example: >-
                    http://www.okon.com/accusantium-harum-mollitia-modi-deserunt-aut-ab
                  nullable: true
                submission_path:
                  type: string
                  description: >-
                    Optional submission path for OnDeck funder automation.
                    Options: `standard` (full documentation required),
                    `pre_approval` (instant soft offers without documents), or
                    `auto` (auto-selects based on config and document
                    availability). Only applies to OnDeck funder. Defaults to
                    `standard`.
                  example: pre_approval
                  enum:
                    - standard
                    - pre_approval
                    - auto
                  nullable: true
                bank_statement_source:
                  type: string
                  description: >-
                    Optional override for which bank-statement source is sent.
                    Options: `bank_statements` (PDFs only) or `plaid_json`
                    (Plaid JSON only). Not all funders support every source;
                    unsupported values are ignored. Omit to use the default
                    order: original statements, then Plaid JSON, then Plaid
                    PDFs.
                  example: bank_statements
                  enum:
                    - bank_statements
                    - plaid_json
              required:
                - method
                - stage_id
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                example:
                  data:
                    placement_id: null
                    application_id: 67b2176c-cc4f-40d1-9418-cd2f038bb60f
                    tracking: ''
                    status: null
                    decline_reason: null
                    decline_reason_id: null
                    decline_subreason_id: null
                    method: 1
                    product_id: 1
                    created_at: null
                    updated_at: null
                    resubmitted_at: null
                    is_client_funded: null
                    can_send_files: false
                    can_resubmit: false
                    via_automation: false
                    submission_path: null
                    reference_workflow_status: null
                    reference_workflow_sub_status: null
                    reference_workflow_status_color: null
                    origin_offer_template_id: 01958b10-0d3c-73d4-99a1-148aece7409d
                    origin_offer_template:
                      id: 01958b10-0d3c-73d4-99a1-148aece7409d
                      name: ARLOC
                      description: null
                      product: arloc
                      is_enabled: true
                      is_default: true
                      is_fallback: true
                      funder_id: null
                      client_id: null
                      created_at: '2025-03-12T15:53:59.000000Z'
                      updated_at: '2026-10-08T15:42:24.000000Z'
                    destinations:
                      - workflow_template_id: null
                        offer_template_id: 01958b10-0d3c-73d4-99a1-148aece7409d
                        offer_template:
                          id: 01958b10-0d3c-73d4-99a1-148aece7409d
                          name: ARLOC
                          description: null
                          product: arloc
                          is_enabled: true
                          is_default: true
                          is_fallback: true
                          funder_id: null
                          client_id: null
                          created_at: '2025-03-12T15:53:59.000000Z'
                          updated_at: '2026-10-08T15:42:24.000000Z'
                    url: null
                properties:
                  data:
                    type: object
                    properties:
                      placement_id:
                        type: string
                        example: null
                        nullable: true
                      application_id:
                        type: string
                        example: 67b2176c-cc4f-40d1-9418-cd2f038bb60f
                      tracking:
                        type: string
                        example: ''
                      status:
                        type: string
                        example: null
                        nullable: true
                      decline_reason:
                        type: string
                        example: null
                        nullable: true
                      decline_reason_id:
                        type: string
                        example: null
                        nullable: true
                      decline_subreason_id:
                        type: string
                        example: null
                        nullable: true
                      method:
                        type: integer
                        example: 1
                      product_id:
                        type: integer
                        example: 1
                      created_at:
                        type: string
                        example: null
                        nullable: true
                      updated_at:
                        type: string
                        example: null
                        nullable: true
                      resubmitted_at:
                        type: string
                        example: null
                        nullable: true
                      is_client_funded:
                        type: string
                        example: null
                        nullable: true
                      can_send_files:
                        type: boolean
                        example: false
                      can_resubmit:
                        type: boolean
                        example: false
                      via_automation:
                        type: boolean
                        example: false
                      submission_path:
                        type: string
                        example: null
                        nullable: true
                      reference_workflow_status:
                        type: string
                        example: null
                        nullable: true
                      reference_workflow_sub_status:
                        type: string
                        example: null
                        nullable: true
                      reference_workflow_status_color:
                        type: string
                        example: null
                        nullable: true
                      origin_offer_template_id:
                        type: string
                        example: 01958b10-0d3c-73d4-99a1-148aece7409d
                      origin_offer_template:
                        type: object
                        properties:
                          id:
                            type: string
                            example: 01958b10-0d3c-73d4-99a1-148aece7409d
                          name:
                            type: string
                            example: ARLOC
                          description:
                            type: string
                            example: null
                            nullable: true
                          product:
                            type: string
                            example: arloc
                          is_enabled:
                            type: boolean
                            example: true
                          is_default:
                            type: boolean
                            example: true
                          is_fallback:
                            type: boolean
                            example: true
                          funder_id:
                            type: string
                            example: null
                            nullable: true
                          client_id:
                            type: string
                            example: null
                            nullable: true
                          created_at:
                            type: string
                            example: '2025-03-12T15:53:59.000000Z'
                          updated_at:
                            type: string
                            example: '2026-10-08T15:42:24.000000Z'
                      destinations:
                        type: array
                        example:
                          - workflow_template_id: null
                            offer_template_id: 01958b10-0d3c-73d4-99a1-148aece7409d
                            offer_template:
                              id: 01958b10-0d3c-73d4-99a1-148aece7409d
                              name: ARLOC
                              description: null
                              product: arloc
                              is_enabled: true
                              is_default: true
                              is_fallback: true
                              funder_id: null
                              client_id: null
                              created_at: '2025-03-12T15:53:59.000000Z'
                              updated_at: '2026-10-08T15:42:24.000000Z'
                        items:
                          type: object
                          properties:
                            workflow_template_id:
                              type: string
                              example: null
                              nullable: true
                            offer_template_id:
                              type: string
                              example: 01958b10-0d3c-73d4-99a1-148aece7409d
                            offer_template:
                              type: object
                              properties:
                                id:
                                  type: string
                                  example: 01958b10-0d3c-73d4-99a1-148aece7409d
                                name:
                                  type: string
                                  example: ARLOC
                                description:
                                  type: string
                                  example: null
                                  nullable: true
                                product:
                                  type: string
                                  example: arloc
                                is_enabled:
                                  type: boolean
                                  example: true
                                is_default:
                                  type: boolean
                                  example: true
                                is_fallback:
                                  type: boolean
                                  example: true
                                funder_id:
                                  type: string
                                  example: null
                                  nullable: true
                                client_id:
                                  type: string
                                  example: null
                                  nullable: true
                                created_at:
                                  type: string
                                  example: '2025-03-12T15:53:59.000000Z'
                                updated_at:
                                  type: string
                                  example: '2026-10-08T15:42:24.000000Z'
                      url:
                        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>

````