Scope: crm:deals.write https://api.alladdin.com/api/v2/leads/{leadId}/dates

Updates the due date of an existing lead.

Parameters

Path parameters

leadId string required

Lead ID

Request body

object due_date string<date>

Required. Expected close date of the opportunity. Accepts a bare date (YYYY-MM-DD) or an ISO 8601 datetime; the time component is normalised to 00:00:00 in the account timezone.

Request

import requests

url = "https://api.alladdin.com/api/v2/leads/{leadId}/dates"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

payload = {
    "due_date": "2026-01-15"
}
response = requests.put(url, headers=headers, json=payload)
print(response.json())

Responses

Response

{
  "id": "string"
}

Success responses

200 Dates updated application/json object id string

Error responses

400 Bad request application/json 401 Invalid or missing API key application/json 403 Insufficient permissions application/json 404 Lead not found application/json 429 Rate limit exceeded application/json

← PreviousUpdate a lead →

Next →Update a lead stage →