Sale Contacts

Add lender contact

Adds a lender contact to the sale. A sale can have only one lender contact; adding another returns 422.

Validation & Requirements

Required Parameters

  • saleGuid (path, string, format=guid)
  • form (body, none)

Required JSON Body Fields

  • None

Validations

  • Invalid GUID values in *Guid/*Guids fields return 422 Unprocessable Entity.
  • Invalid date values in *date* fields return 422 Unprocessable Entity.
  • Missing required request body returns 422 Unprocessable Entity with Missing request body..
  • Additional business-rule validation may return 422 with details in the errors array.
  • Phone, fax, and alternate phone values must be exactly 10 numeric digits (no separators).
  • If email is provided, it must be a valid email format.
  • City cannot contain numeric digits.
  • For non-cash deals, lender first name, last name, company, and loan type are required.
  • LoanTypeId must be a valid loan type for the subscriber.

Integration Requirement

  • Retrieve the corresponding ...Form endpoint immediately before write operations to get current dynamic required fields and allowed values.
post/api/files/sales/{saleGuid}/lenderContact

Path parameters

saleGuidstring guid required

GUID of the sale you want to add a lender contact to.

Request body

{"stackTrail":"paths:/api/files/sales/{saleGuid}/lenderContact:post:requestBody:content:application/json:schema","oasType":"schema","type":"unknown"}

Response

warningsstring[] nullable