latestOpenAPI 3.0.02026-08-12207455917.9 KB
bad0d2db9b7a
Listing Contacts
Add seller contact
Adds a seller contact to the listing. A listing can have up to 5 seller contacts; adding another returns 422. A seller contact is required for the listing to transition from Incomplete to Active — home-warranty (/homeWarrantyContact) and miscellaneous (/miscellaneousContact) contacts do not satisfy this requirement.
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}/sellerContact
Path parameters
listingGuidstring guid required
GUID of the listing you want to add a seller contact to.