Applicants: put

Update an Applicant.

Request - PUT https://api-uat.vtopenview.com/applicants/{applicantid}

You will need to supply a request body and supply the Applicant Id on your request parameters with this method.
You will need to include your access token upon making a request. For more information, see the authentication and authorization page.

Example request with authorization:

curl -- PUT Base URI: https://api-uat.vtopenview.com/applicants/{applicantid} --header "Authorization: Bearer MTQ0NjJkZmQ5OTM2NDE1ghNNBiuyUYUN"

Request Body

Example request body:

Content-Type: application/json { "applicantid": long, "lettings": boolean, "sales": boolean, "title": "string", "forename": "string", "surname": "string", "companyname": "string", "website": "string", "phone": "string", "workphone": "string", "mobilephone": "string", "email": "string", "salutation": "string", "source": "string", "temperature": "string", "internalreference": "string", "negotiator": { "userid": long, "name": "string", "email": "string" }, "branch": { "branchid": integer, "branchname": "string" }, "status": "string", "contactnotes": "string", "additionalinformation": "string", "address": { "houseno": "string", "address1": "string", "address2": "string", "town": "string", "county": "string", "postcode": "string", "latitude": decimal, "longitude": decimal, "geocodingverified": boolean, "countryname": "string", "countrydisplayname": "string", "fulladdress": "string", "shortaddress": "string" }, "criteria": { "areas": [ { "area": "string", "miles": decimal, } ], "minprice": decimal, "maxprice": decimal, "bedrooms": integer, "bathrooms": integer, "moveindate": "date", "buyerposition": "string", "propertyattributes": [ { "attribute": "string", } ], "propertystyle": [ { "style": "string", } ], "propertytype": [ { "type": "string" "isActive": boolean, } ] }, "udf": [ { "udfid": long, "value": "string" } ] }, "gdprpreferences": { "doupdate": boolean, "usedefault": boolean, "email": boolean, "letter": boolean, "sms": boolean, "phone": boolean, "thirdparty": boolean, "marketing": boolean, "donotcontact": boolean, "checkedby": long, "datechecked": "date" } }

Source Types:

The list below describes the possible sources types for applicants. This field is optional.

Walk In
Friend
Recommendation
Website
Rightmove
Zoopla
On The Market
Prime Location

Example field on request:

"source": "Walk In"

Property Type Expected Values:

The list below describes the possible property types. This field is optional.

Not Specified
Terraced House
End of Terrace House
Semi-Detached House
Detached House
Mews House
Cluster House
Ground Floor Flat
Flat
Studio Flat
Ground Floor Maisonette
Maisonette
Bungalow
Terraced Bungalow
Semi-Detached Bungalow
Detached Bungalow
Mobile Home
Land (Residential)
Link Detached House
Town House

Cottage
Chalet
Character Property
House
Villa
Apartment
Penthouse
Fina
Barn Conversion
Serviced Apartment
Parking
Sheltered Housing
Retirement Property
House Share
Flat Share
Park Home
Garages
Farm House
Equestrian Facility
Duplex

Triplex
Longere
Gite
Barn
Trulli
Mill
Ruins
Restaurant
Cafe
Castle
Village House
Cave House
Cortijo
Farm Land
Plot
Country House
Stone House
Caravan
Lodge
Log Cabin

Example field on request:

"propertytype": [ { "type": "Ground Floor Maisonette", "isActive": true } ]

Status:

The list below describes the possible status for applicants. This field is required.
If your company has set up other statuses on OpenView, please verify the string you are sending.

Active
Inactive
Archived

Example field on request:

"status": "Active"

Temperature:

The list below describes the possible temperatures types for applicants. This field is optional.

Cold
Hot
Warm

Example field on request:

"temperature": "Hot"

Buyer Position:

The list below describes the possible buyer positions types for applicants. This field is optional and it's only available for Sales Applicants.
If your company has set up other buyer positions types on OpenView, please verify the string you are sending.

Cash Buyer
First Time Buyer

Example field on request:

"buyerposition": "First Time Buyer"

Response

If successful, this method returns a response body with the following structure:

Example response:

HTTPS 200 OK Content-Type: application/json { "applicantid": long, "lettings": boolean, "sales": boolean, "title": "string", "forename": "string", "surname": "string", "companyname": "string", "website": "string", "phone": "string", "workphone": "string", "mobilephone": "string", "email": "string", "salutation": "string", "source": "string", "temperature": "string", "internalreference": "string", "negotiator": { "userid": long, "name": "string", "email": "string" }, "branch": { "branchid": integer, "branchname": "string" }, "status": "string", "contactnotes": "string", "additionalinformation": "string", "address": { "houseno": "string", "address1": "string", "address2": "string", "town": "string", "county": "string", "postcode": "string", "latitude": decimal, "longitude": decimal, "geocodingverified": boolean, "countryname": "string", "countrydisplayname": "string", "fulladdress": "string", "shortaddress": "string" }, "criteria": { "areas": [ { "area": "string", "miles": decimal, } ], "minprice": decimal, "maxprice": decimal, "bedrooms": integer, "bathrooms": integer, "moveindate": "date", "buyerposition": "string", "propertyattributes": [ { "attribute": "string", } ], "propertystyle": [ { "style": "string", } ], "propertytype": [ { "propertytypeid": integer, "propertytypeName": "string" } ], }, "udf": [ { "udfid": long, "value": "string" } ] }