---
title: "Create a new proposal | Criar uma nova proposta"
method: POST
path: "/proposals"
tags: ["Proposals | Propostas"]
---

# Create a new proposal | Criar uma nova proposta

`POST /proposals`

Creates a new loan proposal based on the provided data | Cria uma nova proposta de crédito baseada nos dados fornecidos

## Request body

- DocsCreateProposalRequest
  - `customer_id` string, required — Customer ID
  - `destination_account` DocsDestinationAccountRequest, required
    - `account_type` string
    - `bank` string
    - `bank_account` string
    - `bank_account_digit` string
    - `bank_branch` string
    - `document` string
    - `name` string
    - `receiver_pix_key` string
    - `receiver_pix_key_type` string
  - `email` string, required
  - `phone` string, required — E.g., 11999998888 or (11) 99999-8888
  - `product_id` string, required — Product ID
  - `simulation_input` DocsExampleSimulationRequest, required
    - `customer_type` 'PF' | 'PJ', required
    - `first_due_date` string, required — Expecting YYYY-MM-DD
    - `include_iof` boolean
    - `interest_rate` number, required
    - `iof_handling_type` 'FINANCED' | 'DISCOUNTED', required
    - `loan_amount` number, required
    - `number_of_installments` integer, required
    - `periodicity_interval` integer
    - `periodicity_unit` 'MONTH' | 'DAY' | 'WEEK', required
    - `registration_fee` number
    - `registration_fee_handling_type` 'FINANCED' | 'DISCOUNTED', required
    - `release_date` string, required — Expecting YYYY-MM-DD
    - `simulation_type` 'SAC' | 'PRICE', required

## Response `201`

Proposal created successfully | Proposta criada com sucesso

- DocsExampleCreateProposal
  - `code` string
  - `data` DocsProposalResponseCreated
    - `code` string
    - `created_at` string
    - `customer_data` DocsCustomerDataListItem
      - `dados_adcionais` string
      - `mail` string
      - `phone` string
    - `destination_account` DocsDestinationAccountListItem
      - `account_type` string
      - `bank` string
      - `bank_account` string
      - `bank_account_digit` string
      - `bank_branch` string
      - `document` string
      - `name` string
      - `receiver_pix_key` string
      - `receiver_pix_key_type` string
    - `document` string
    - `id` string
    - `simulation` DocsSimulationResponseProposal
      - `cet_annual` number
      - `cet_monthly` number
      - `customer_type` string
      - `first_due_date` string
      - `include_iof` boolean
      - `installments` DocsInstallmentExample[]
        - `balance` number
        - `due_date` string
        - `installment_number` integer
        - `interest_amount` number
        - `payment_amount` number
        - `principal_amount` number
      - `interest_rate` number
      - `iof_amount` number
      - `iof_handling_type` string
      - `loan_amount` number
      - `net_amount_released` number
      - `number_of_installments` integer
      - `periodicity_interval` integer
      - `periodicity_unit` string
      - `registration_fee` number
      - `registration_fee_handling_type` string
      - `release_date` string
      - `simulation_type` string
      - `total_amount_paid` number
      - `total_financed_amount` number
    - `status` string
    - `step` string
    - `updated_at` string
  - `message` string
  - `request_id` string

## Other responses

- `400` — Bad Request - Invalid input data | Solicitação inválida - Dados de entrada inválidos
- `500` — Internal Server Error | Erro interno do servidor

---

[API](https://skmtc.net/fitbank/apis/onboarding.md) · [All operations](https://skmtc.net/fitbank/apis/onboarding/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fitbank/onboarding/versions/f94d262a8f58/schema)