Skip to main content
POST
cURL
Existing integrations using this operation must provide their configured scheduleType identifier. Unsupported identifiers are rejected; the values from GET /origination/task-types are not identifiers for this operation. For new-application or returning-borrower outreach, use Origination Enrollment. For accounts configured for loan-based collections boarding, create the customer and then use Create Loan.

Customer lookup

customerId is the customer reference ID you supplied when creating the customer, not a Finosu UUID. An unknown reference ID for your company returns 404.

Response

Returns 201 with the array of scheduled calls created. customerId echoes your customer reference ID, scheduledTime is an ISO 8601 timestamp with UTC offset, and each call starts in status PENDING. callId is null until a call is placed for the entry.

Errors

Invalid scheduleType values or a missing/invalid customer timezone or missing/blank state return 422. Unexpected failures while creating the schedule return 500.

Authorizations

X-API-Key
string
header
required

Path Parameters

customerId
string
required

ID of customer

Body

application/json

Required scheduling configuration for existing integrations.

scheduleType
string
required

Configured schedule identifier. Use the value assigned to your integration; unsupported values are rejected. This is not a taskType from GET /origination/task-types.

Response

Array of scheduled calls created

id
string
required

Identification number of the scheduled call

customerId
string
required

ID of the customer

scheduledTime
string
required

Scheduled time of the call

status
string
required

Status of the scheduled call

callId
string | null

Finosu call UUID, or null before a call is associated with this schedule.

postProcessingFlags
null

Currently always null. This endpoint exposes scheduling state, not call outcome flags. Use the configured call webhook flags field for delivered outcomes.