---
title: "Update Lead Followups"
method: POST
path: "/leads/{leadId}/followup"
---

# Update Lead Followups

`POST /leads/{leadId}/followup`

Lets you update the recent follow up date and till id of a lead.

## Path parameters

- `leadId` string, required

## Request body

- object
  - `followedUpBy` integer — Unique ID of the staff who followed up.
  - `createdOn` string, date — Date and time of lead creation in YYYY-MM-DDThh:mm:ssTZD format. Example: 2018-10-05T08:00:00+05:30
  - `followedUpOn` string, date, required — Date of recent follow up discussion with the customer in YYYY-MM-DDTHH:MM:SS+TZD
  - `createdBy` integer, required — Till ID that updated the follow up
  - `nextFollowUp` string, date — Date and time of the next follow up discussion with the customer in YYYY-MM-DDTHH:MM:SS+TZD
  - `notes` string — Brief follow up notes.
  - `scheduledFollowUp` string, date — Actual scheduled date and time of the current follow up discussion with the customer in YYYY-MM-DDTHH:MM:SS+TZD

## Response `200`

200

- object
  - `createdBy` integer
  - `createdOn` string
  - `extendedFields` object
    - `trial_status` string
  - `followUpDetails` object[]
    - `createdBy` integer
    - `createdOn` string
    - `followedUpBy` integer
    - `followedUpOn` string
    - `id` integer
    - `leadId` integer
    - `notes` string
    - `scheduledFollowUp` string
    - `userId` integer
  - `id` integer
  - `lastFollowUp` string
  - `lastUpdatedBy` integer
  - `lastUpdatedOn` string
  - `leadFor` string
  - `orgSourceId` integer
  - `status` string
  - `statusLogDetails` object[]
    - `createdBy` integer
    - `createdOn` string
    - `id` integer
    - `leadId` integer
    - `reason` string
    - `reasonId` integer
    - `status` string
    - `userId` integer
  - `type` string
  - `userId` integer
  - `warnings` unknown[]
    - unknown

---

[API](https://skmtc.net/capillarytech/apis/sample-api.md) · [All operations](https://skmtc.net/capillarytech/apis/sample-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/capillarytech/sample-api/revisions/de241f2ed9b3/schema)