---
title: "Update installments for a lead"
method: POST
path: "/leads/{id}/installments"
tags: ["Leads"]
---

# Update installments for a lead

`POST /leads/{id}/installments`

Replaces the lead's installment schedule. The request body is a JSON array of installment objects (`id`, `dueTime`, `description`, `value`, `isFailed`). `dueTime` is an ISO 8601 string. Requires lead installments on the account plan.

## Path parameters

- `id` string, required

## Request body

- object[]
  - `id` string
  - `dueTime` string, required
  - `description` string
  - `value` string, required
  - `isFailed` boolean, required

## Response `200`

Updated installments

- object
  - `installments` LeadInstallment[], required
    - `id` string
    - `dueTime` string
    - `description` string
    - `value` LeadInstallmentValue
      - `currency` string
      - `amount` number, float
    - `failedTime` string
    - `isPaid` boolean

---

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