latestOpenAPI 3.0.02026-08-12207455917.9 KB

bad0d2db9b7a

Listing Contacts

Add miscellaneous contact

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

Validation & Requirements

Required Parameters

  • listingGuid (path, string, format=guid)
  • form (body, object)

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.

Integration Requirement

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

Path parameters

listingGuidstring guid required

GUID of the listing you want to add a miscellaneous contact to.

Request body

miscContactTypestring nullable
firstNamestring nullable
lastNamestring nullable
phoneNumberstring nullable
alternatePhonestring nullable
emailstring nullable
notesstring nullable
companystring nullable
streetNumberstring nullable
streetNamestring nullable
zipstring nullable
statestring nullable
citystring nullable
faxstring nullable

Response

warningsstring[] nullable