API Reference›Servicing Plane›Scheduled callbacks›Schedule a callback on a case

Schedule a callback on a case

POSThttps://sandbox.api.lendeasy.ai/v1/servicing/cases/{caseId}/scheduled-callbacksImplementedBearer token ·CREATE_SERVICING_SCHEDULED_CALLBACK

Records a borrower-promised callback window as one scheduled task and one scheduled interaction created together. The case supplies the customer and loan, the window must be a future 5–120 minute span in the borrower’s known time zone, an outside-hours window requires the borrower’s recorded agreement, and a case holds at most one unresolved callback.

Request

curl -X POST https://sandbox.api.lendeasy.ai/v1/servicing/cases/$CASE_ID/scheduled-callbacks \
  -H "Authorization: Bearer $TOKEN" \
  -H "LendEasy-Tenant: $TENANT" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "windowStart": "2026-07-26T15: 00:00Z",
  "windowEnd": "2026-07-26T15: 30:00Z",
  "contactPointRef": "phone-1",
  "reasonCode": "COLLECTIONS_FOLLOW_UP",
  "summary": "Customer asked to be called back about the missed payment.",
  "outsideHoursAgreement": {
    "borrowerAgreed": true,
    "evidenceSource": "CALL_RECORDING",
    "evidenceRef": "call-transcript-731"
  }
}'

await fetch(`https://sandbox.api.lendeasy.ai/v1/servicing/cases/${caseId}/scheduled-callbacks`, {
  method: "POST",
  headers: { Authorization: `Bearer ${token}`, "LendEasy-Tenant": tenant, "Idempotency-Key": idempotencyKey, "Content-Type": "application/json" },
  body: JSON.stringify({
  "windowStart": "2026-07-26T15: 00:00Z",
  "windowEnd": "2026-07-26T15: 30:00Z",
  "contactPointRef": "phone-1",
  "reasonCode": "COLLECTIONS_FOLLOW_UP",
  "summary": "Customer asked to be called back about the missed payment.",
  "outsideHoursAgreement": {
    "borrowerAgreed": true,
    "evidenceSource": "CALL_RECORDING",
    "evidenceRef": "call-transcript-731"
  }
}),
});

requests.post(
  f"https://sandbox.api.lendeasy.ai/v1/servicing/cases/{case_id}/scheduled-callbacks",
  headers={"Authorization": f"Bearer {token}", "LendEasy-Tenant": tenant, "Idempotency-Key": idempotency_key},
  json={
  "windowStart": "2026-07-26T15: 00:00Z",
  "windowEnd": "2026-07-26T15: 30:00Z",
  "contactPointRef": "phone-1",
  "reasonCode": "COLLECTIONS_FOLLOW_UP",
  "summary": "Customer asked to be called back about the missed payment.",
  "outsideHoursAgreement": {
    "borrowerAgreed": true,
    "evidenceSource": "CALL_RECORDING",
    "evidenceRef": "call-transcript-731"
  }
},
)

{
  "taskId": 2001,
  "interactionId": 3001,
  "caseId": 1001,
  "status": "SCHEDULED",
  "windowStart": "2026-07-26T15: 00:00Z",
  "windowEnd": "2026-07-26T15: 30:00Z",
  "scheduledZoneId": "America/Chicago"
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "400",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "validation.msg.validation.errors.exist",
  "errors": []
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "401",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "error.msg.not.authenticated",
  "errors": []
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "403",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "error.msg.not.authorized",
  "errors": []
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "404",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "error.msg.resource.not.found",
  "errors": []
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "409",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "idempotency.request.in.flight",
  "errors": []
}

Path & query parameters

Field	Type	Description
LendEasy-Tenant required in header	string	Opaque active LendEasy tenant-registry identifier. Supply exactly one instance; no alternate tenant selector is accepted.
caseId required in path	integer	Positive numeric case identifier.
Idempotency-Key optional in header	string	Optional replay key for this logical mutation. Omission creates a fresh server-owned key for this attempt; blank, repeated, or longer-than-50-character values are rejected.

Body parameters

Field	Type	Description
windowStart required	string
windowEnd required	string
contactPointRef required	string
reasonCode required	string	Configured structured reason code.
summary optional	string
outsideHoursAgreement optional	object
borrowerAgreed	boolean
evidenceSource	string
evidenceRef	string

Request

curl -X POST https://sandbox.api.lendeasy.ai/v1/servicing/cases/$CASE_ID/scheduled-callbacks \
  -H "Authorization: Bearer $TOKEN" \
  -H "LendEasy-Tenant: $TENANT" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "windowStart": "2026-07-26T15: 00:00Z",
  "windowEnd": "2026-07-26T15: 30:00Z",
  "contactPointRef": "phone-1",
  "reasonCode": "COLLECTIONS_FOLLOW_UP",
  "summary": "Customer asked to be called back about the missed payment.",
  "outsideHoursAgreement": {
    "borrowerAgreed": true,
    "evidenceSource": "CALL_RECORDING",
    "evidenceRef": "call-transcript-731"
  }
}'

await fetch(`https://sandbox.api.lendeasy.ai/v1/servicing/cases/${caseId}/scheduled-callbacks`, {
  method: "POST",
  headers: { Authorization: `Bearer ${token}`, "LendEasy-Tenant": tenant, "Idempotency-Key": idempotencyKey, "Content-Type": "application/json" },
  body: JSON.stringify({
  "windowStart": "2026-07-26T15: 00:00Z",
  "windowEnd": "2026-07-26T15: 30:00Z",
  "contactPointRef": "phone-1",
  "reasonCode": "COLLECTIONS_FOLLOW_UP",
  "summary": "Customer asked to be called back about the missed payment.",
  "outsideHoursAgreement": {
    "borrowerAgreed": true,
    "evidenceSource": "CALL_RECORDING",
    "evidenceRef": "call-transcript-731"
  }
}),
});

requests.post(
  f"https://sandbox.api.lendeasy.ai/v1/servicing/cases/{case_id}/scheduled-callbacks",
  headers={"Authorization": f"Bearer {token}", "LendEasy-Tenant": tenant, "Idempotency-Key": idempotency_key},
  json={
  "windowStart": "2026-07-26T15: 00:00Z",
  "windowEnd": "2026-07-26T15: 30:00Z",
  "contactPointRef": "phone-1",
  "reasonCode": "COLLECTIONS_FOLLOW_UP",
  "summary": "Customer asked to be called back about the missed payment.",
  "outsideHoursAgreement": {
    "borrowerAgreed": true,
    "evidenceSource": "CALL_RECORDING",
    "evidenceRef": "call-transcript-731"
  }
},
)

{
  "taskId": 2001,
  "interactionId": 3001,
  "caseId": 1001,
  "status": "SCHEDULED",
  "windowStart": "2026-07-26T15: 00:00Z",
  "windowEnd": "2026-07-26T15: 30:00Z",
  "scheduledZoneId": "America/Chicago"
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "400",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "validation.msg.validation.errors.exist",
  "errors": []
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "401",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "error.msg.not.authenticated",
  "errors": []
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "403",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "error.msg.not.authorized",
  "errors": []
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "404",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "error.msg.resource.not.found",
  "errors": []
}

{
  "developerMessage": "Request was understood but rejected; inspect errors for field-level causes.",
  "httpStatusCode": "409",
  "defaultUserMessage": "The request could not be applied.",
  "userMessageGlobalisationCode": "idempotency.request.in.flight",
  "errors": []
}