---
title: "POST /leads/{leadId}/loan/events"
method: POST
path: "/leads/{leadId}/loan/events"
tags: ["Onboarding - Leads"]
---

# POST /leads/{leadId}/loan/events

`POST /leads/{leadId}/loan/events`

## Request

- Base URL: `https://partners.staging-youlendapi.com/testsupport`
- URL: `https://partners.staging-youlendapi.com/testsupport/leads/{leadId}/loan/events`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://youlend-stag.eu.auth0.com/oauth/token`

## Path parameters

- `leadId` string, uuid, required

## Headers

- `api-version` string

## Request body

- LoanLifecycleEventRequest
  - `eventType` 'Unknown' | 'Funded' | 'Repaid' | 'Defaulted' | 'WrittenOff' | 'DiscountedSettlement' | 'RenewalWithOpenBalance': Supported loan lifecycle events for TestSupport.
  - `occurredAt` string, date-time, nullable
  - `defaulted` LoanDefaultPayload
    - `reason` string, nullable
    - `reasonDetails` string, nullable
    - `recoveryPartnerId` string, uuid, nullable
  - `writtenOff` LoanWrittenOffPayload
    - `reason` string, nullable
    - `reasonDetails` string, nullable
    - `writeOffAmount` number, double
    - `freezeCurrentAmount` boolean
    - `recoveryPartnerId` string, uuid, nullable
  - `discountedSettlement` LoanDiscountedSettlementPayload
    - `reason` string, nullable
    - `furtherDetails` string, nullable

## Response `200`

OK

- LoanLifecycleEventResponse
  - `loanId` string, uuid
  - `eventType` 'Unknown' | 'Funded' | 'Repaid' | 'Defaulted' | 'WrittenOff' | 'DiscountedSettlement' | 'RenewalWithOpenBalance': Supported loan lifecycle events for TestSupport.
  - `status` string, nullable

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/youlend/apis/testsupport.md) - [All operations](https://skmtc.dev/youlend/apis/testsupport/llms.txt) - [OpenAPI document](https://skmtc.dev/youlend/apis/testsupport/revisions/1bf6a5e57f46?raw)