{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":["code-snippet","admonition"]},"type":"markdown"},"seo":{"title":"Managing contact details","siteUrl":"https://developers.booking.com","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"managing-contact-details","__idx":0},"children":["Managing contact details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contacts-api"]}," endpoint to create, update, retrieve and delete contact details."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This topic covers how to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#creating-contact-details"},"children":["Create contact details"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#overwriting-contact-details"},"children":["Update/overwrite/delete  contact details"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#retrieving-contact-details"},"children":["Retrieve contact details"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"creating-contact-details","__idx":1},"children":["Creating contact details"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"PUT\nhttps://supply-xml.booking.com/contacts-api/properties/{propertyID}/contacts\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can create multiple contacts with different contact types but with the same contact details."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"what-are-contact-profile-types","__idx":2},"children":["What are contact profile types?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Creating contact information with certain contact profile types is crucial to bringing a property to the open and bookable status."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can create a contact based on the following contact profile types:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["General: Primary point of contact for the property."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Invoices: Contact for accounts payable."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reservations: Contact for reservations."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Availability: Contact for questions about availability."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Site_content: Contact for photos, descriptions and other website content."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Parity: Contact for pricing and rate topics."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Requests: Contact for special requests."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Central_reservations: Contact for central reservations. Applies to properties that manage reservations centrally."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Physical location is no longer a contact profile type."," ","You can add physical location details using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["property-api"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"api-validations","__idx":3},"children":["API validations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This section contains any validations that the API enforces when processing a create contacts request."," ","Make sure your request meets these validations."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You can create at a maximum one contact details per property for the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["General"]}," contact type."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You can have multiple contacts for other contact profile types."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The invoice contact is the person who can be contacted to discuss invoices. This is not a mandatory contact type. It is located in the Property Settings API where you must specify the address for invoices."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You can update the contact details for the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["General"]}," contact type."," ","Because this endpoint uses overlay, when updating other contact type details, make sure to also send the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["General"]}," contact details. Failing to send this in the update request will return an error."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Creating a contact of type ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invoices"]}," is optional. However, to make a property open and bookable, you must add ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}," details for invoice contact using the Property settings (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /property-settings"]},") endpoint."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You cannot send the same contact details with identical contact types in a single request."," ","However, you can send the same contact details with different contact types. In this case, the API creates one contact for all contact types."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The phone number is validated based on the formatting rules of the specified country code."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"header-parameter","__idx":4},"children":["Header parameter"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table describes the elements you can add in the header:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Header"},"children":["Header"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required/  Optional"},"children":["Required/",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Optional"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notes"},"children":["Notes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Content-Type: application/json"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the expected content type."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Accept-Version"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specify the version number to get the API functionality specific to that version."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Currently supports the value:  1.0"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"path-parameter","__idx":5},"children":["Path parameter"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table describes the elements you can add in the path:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required/  Optional"},"children":["Required/",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Optional"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notes"},"children":["Notes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["{",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["propertyID"]},"} value"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specify the unique ID of the property where you want to create contact details."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"request-body-parameters","__idx":6},"children":["Request body parameters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table describes the elements you can add in the request body:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Element"},"children":["Element"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Attribute"},"children":["Attribute"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required/  Optional"},"children":["Required/",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Optional"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notes"},"children":["Notes"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Root parameter in HDCN"},"children":["Root parameter in HDCN"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contacts"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains contact information."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You must create one contact details for the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["General"]}," contact type. Note that you can create at a maximum only one contact detail per property for the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["General"]}," contact type."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contact_profile_type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains the contact type."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos > ContactInfo.ContactProfileType"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the type of contact."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enumerated string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For a list of approved contact types, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#contact-profile-types"},"children":["ContactProfileType."]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains the address details of the contact including country, city and postal code details."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional for all contact types"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You can set only one address per contact type."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["city_name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Species the name of the city, town, or village."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}," is specified"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["state_prov_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains the State/province details."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The value specified in this field is not returned in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," call."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Species the two-letter country code."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enumerated string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}," is specified"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For more information on how to retrieve the country code details, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/b_xml-countries"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["xml/countries"]}," endpoint."]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["postal_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the postal/zip code."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}," is specified"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Make sure the postal code is relevant to the country specified in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country_code"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address_line"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Species the full street name and number."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}," is specified"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Should not contain abbreviations (such as \"Rd.\" for \"Road\") and should not exceed 255 characters."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["language_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Species the Booking.com Language code for the address details."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enumerated string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}," is specified"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For a list of supported language codes, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/codes-bcl"},"children":["Booking.com Language Code table"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contact_person"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains the contact person's name, gender, spoken language and job title."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["New field."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["language_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Species the contact's spoken language(s)."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enumerated string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For a list of supported language codes, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/codes-bcl"},"children":["Booking.com Language Code table"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gender"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the contact's gender."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enumerated string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Accepts: Male, Female. Default: null. To set as empty, omit the entire attribute (instead of specifying \"\")."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the contact person's full name."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["job_title"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the contact person's job title code."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enumerated string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For a list of supported job titles and their code, see  ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/codes-bcjt"},"children":["Booking.com Job Title Code"]},". By default, it is set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Unknown"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phones"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains the phone number information."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phone_number"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the international phone number."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Follows the format: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\\+[0-9]+"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"The phone number is also validated based on the formatting rules of the specified country code."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phone_tech_type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the type of phone line/device."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enumerated string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For a list of supported values, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/codes-ptt"},"children":["PTT"]},". ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," PhoneTechType 3 can have at most 3 entries. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," PhoneTechType 1 and 5 can have at most 1 entry. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," Extension can only be provided for PhoneTechType 1."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extension"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The extension number that must be dialled in addition to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phone_number"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Only accepted when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phone_tech_type=\"1\""]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains the email address details."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Make sure to specify a valid email address."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"contact-profile-types","__idx":7},"children":["Contact Profile Types"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contacts-api"]}," accepts the following values for the contact profile type."," ","Each value corresponds to a similarly named heading on the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Contacts"]}," page in our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://admin.booking.com"},"children":["extranet"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A property must have all the required contact profiles before you can ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/preparing-a-property-to-be-open-bookable"},"children":["open"]}," it."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["general"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Primary point of contact for the property."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reservations"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact for reservations."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invoices"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact for accounts payable."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["availability"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact for questions about availability."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["site_content"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact for photos, descriptions, and other website content."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["parity"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact for pricing and rate matters."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requests"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact for special requests."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["central_reservations"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact for central reservations. Applies to properties that manage reservations from another location."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"request-body","__idx":8},"children":["Request body"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following is a request body example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"/connectivity/docs/code/content-api-modules/POST-create-contact-details-rq.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n  \"contacts\": [\n    {\n      \"contact_profiles\": [\n        {\n          \"type\": \"invoices\"\n        }\n      ],\n      \"address\": {\n        \"city_name\": \"Amsterdam\",\n        \"country_code\": \"NL\",\n        \"postal_code\": \"1011 DL\",\n        \"address_line\": \"New Straat 123\",\n        \"language_code\": \"en-gb\"\n      },\n      \"contact_person\": {\n        \"gender\": \"female\",\n        \"name\": \"Waddington Bloem\",\n        \"job_title\": \"Administration Employee\",\n        \"language_code\": \"en-gb\"\n      },\n      \"phones\": [\n        {\n          \"phone_number\": \"+31002666661\",\n          \"phone_tech_type\": \"1\",\n          \"extension\": \"1\"\n        }\n      ],\n      \"email\": \"test@booking.com\"\n    },\n    {\n      \"contact_profiles\": [\n        {\n          \"type\": \"general\"\n        }\n      ],\n      \"address\": {\n        \"city_name\": \"Amsterdam\",\n        \"country_code\": \"NL\",\n        \"postal_code\": \"1011 DL\",\n        \"address_line\": \"New Straat 456\",\n        \"language_code\": \"en-gb\"\n      },\n      \"contact_person\": {\n        \"gender\": \"male\",\n        \"name\": \"Bensen Clay\",\n        \"job_title\": \"Administration Employee\",\n        \"language_code\": \"en-gb\"\n      },\n      \"phones\": [\n        {\n          \"phone_number\": \"+31002666661\",\n          \"phone_tech_type\": \"1\",\n          \"extension\": \"1\"\n        }\n      ],\n      \"email\": \"tests@booking.com\"\n    }\n  ]\n}\n\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-body","__idx":9},"children":["Response body"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following is a response body example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"/connectivity/docs/code/content-api-modules/POST-create-contact-details-rs.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n  \"warnings\": [],\n  \"meta\": {\n    \"ruid\": \"5rw83de5-54tt-45ad-a75c-af451309f764\"\n  }\n}\n\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-body-elements","__idx":10},"children":["Response body elements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table describes the response elements:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Element"},"children":["Element"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Attribute"},"children":["Attribute"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notes"},"children":["Notes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["warnings"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains any warnings in the response."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["meta"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains metadata information about the response."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ruid"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the unique request ID."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You can share this ID with Booking.com customer support when you run into an issue. This can help in understanding what went wrong."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overwriting-contact-details","__idx":11},"children":["Overwriting contact details"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"PUT\nhttps://supply-xml.booking.com/contacts-api/properties/{propertyID}/contacts\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT contacts-api"]}," endpoint along with the property ID as a path parameter to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["overwrite existing contact details."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["delete contact details by omitting them in the request."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Note that all existing contact details are lost and only the details sent in this request are added as new."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"Retaining existing contact details"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To retain any existing contact details that do not need an update, make sure to add them to the request."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"api-validations-1","__idx":12},"children":["API validations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This section contains any validations that the API enforces when processing an overwrite to contact details."," ","Make sure your request meets these validations."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You can create at a maximum one contact details per property for the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["General"]}," contact type."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You can have multiple contacts for other contact profile types."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The invoice contact is the person who can be contacted to discuss invoices. This is not a mandatory contact type. It is located in the Property Settings API where you must specify the address for invoices."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You can update the contact details for the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["General"]}," contact type."," ","Because this endpoint uses overlay, when updating other contact type details, make sure to also send the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["General"]}," contact details. Failing to send this in the update request will return an error."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Creating a contact of type ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invoices"]}," is optional. However, to make a property open and bookable, you must add ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}," details for invoice contact using the Property settings (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /property-api/properties/{{property_id}}/settings"]},") endpoint."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You cannot send the same contact details with identical contact types in a single request."," ","However, you can send the same contact details with different contact types. In this case, the API creates one contact for all contact types."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The phone number is validated based on the formatting rules of the specified country code."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"header-parameter-1","__idx":13},"children":["Header parameter"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table describes the elements you can add in the header:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Header"},"children":["Header"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required/  Optional"},"children":["Required/",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Optional"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notes"},"children":["Notes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Accept-Version"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specify the version number to get the API functionality specific to that version."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Currently supports the value:  1.0"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"path-parameter-1","__idx":14},"children":["Path parameter"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table describes the elements you can add in the path:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required/  Optional"},"children":["Required/",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Optional"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notes"},"children":["Notes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["{",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["propertyID"]},"} value"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specify the unique ID of the property whose contact details you want to update."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"request-body-parameters-1","__idx":15},"children":["Request body parameters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table describes the elements you can add in the request body:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Element"},"children":["Element"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Attribute"},"children":["Attribute"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required/  Optional"},"children":["Required/",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Optional"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notes"},"children":["Notes"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Name in HDCN"},"children":["Name in HDCN"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contacts"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains contact information."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You must create one contact details for the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["General"]}," contact type. Note that you can create at a maximum only one contact detail per property for the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["General"]}," contact type."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contact_profile_type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains the contact type."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos > ContactInfo.ContactProfileType"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the type of contact."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enumerated string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For a list of approved contact types, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#contact-profile-types"},"children":["ContactProfileType."]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains the address details of the contact including country, city and postal code details."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional for all contact types"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You can set only one address per contact type."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["city_name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Species the name of the city, town, or village."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}," is specified"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["state_prov_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains the State/province details."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The value specified in this field is not returned in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," call."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Species the two-letter country code."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enumerated string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}," is specified"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For more information on how to retrieve the country code details, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/b_xml-countries"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["xml/countries"]}," endpoint."]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["postal_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the postal/zip code."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}," is specified"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Make sure the postal code is relevant to the country specified in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country_code"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address_line"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Species the full street name and number."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}," is specified"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Should not contain abbreviations (such as \"Rd.\" for \"Road\") and should not exceed 255 characters."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["language_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Species the Booking.com Language code for the address details."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enumerated string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}," is specified"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For a list of supported language codes, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/codes-bcl"},"children":["Booking.com Language Code table"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contact_person"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains the contact person's name, gender, spoken language and job title."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["New field."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["language_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Species the contact's spoken language(s)."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enumerated string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For a list of supported language codes, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/codes-bcl"},"children":["Booking.com Language Code table"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gender"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the contact's gender."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enumerated string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Accepts: Male, Female. Default: null. To set as empty, omit the entire attribute (instead of specifying \"\")."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the contact person's full name."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["job_title"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the contact person's job title code."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enumerated string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For a list of supported job titles and their code, see  ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/codes-bcjt"},"children":["Booking.com Job Title Code"]},". By default, it is set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Unknown"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phones"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains the phone number information."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phone_number"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the international phone number."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Follows the format: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\\+[0-9]+"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"The phone number is also validated based on the formatting rules of the specified country code."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phone_tech_type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the type of phone line/device."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enumerated string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For a list of supported values, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/codes-ptt"},"children":["PTT"]},". ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," PhoneTechType 3 can have at most 3 entries. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," PhoneTechType 1 and 5 can have at most 1 entry. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," Extension can only be provided for PhoneTechType 1."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extension"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The extension number that must be dialled in addition to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phone_number"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Only accepted when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phone_tech_type=\"1\""]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains the email address details."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Make sure to specify a valid email address."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/tsk-create-property/#contactinfos"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>>"]}," ContactInfos"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"request-body-1","__idx":16},"children":["Request body"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following is a request body example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"/connectivity/docs/code/content-api-modules/PUT-update-contact-details-rq.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n  \"contacts\": [\n    {\n      \"contact_profiles\": [\n        {\n          \"type\": \"invoices\"\n        }\n      ],\n      \"address\": {\n        \"city_name\": \"Amsterdam\",\n        \"country_code\": \"NL\",\n        \"postal_code\": \"1011 DL\",\n        \"address_line\": \"New Straat 123\",\n        \"language_code\": \"en-gb\"\n      },\n      \"contact_person\": {\n        \"gender\": \"female\",\n        \"name\": \"Lucy Gilean\",\n        \"job_title\": \"Administration Employee\",\n        \"language_code\": \"en-gb\"\n      },\n      \"phones\": [\n        {\n          \"phone_number\": \"+31002666661\",\n          \"phone_tech_type\": \"1\",\n          \"extension\": \"1\"\n        }\n      ],\n      \"email\": \"tests@booking.com\"\n    },\n    {\n      \"contact_profiles\": [\n        {\n          \"type\": \"general\"\n        }\n      ],\n      \"address\": {\n        \"city_name\": \"Amsterdam\",\n        \"country_code\": \"NL\",\n        \"postal_code\": \"1011 DL\",\n        \"address_line\": \"New Straat 456\",\n        \"language_code\": \"en-gb\"\n      },\n      \"contact_person\": {\n        \"gender\": \"male\",\n        \"name\": \"Kevin Mcmartin\",\n        \"job_title\": \"General Manager\",\n        \"language_code\": \"en-gb\"\n      },\n      \"phones\": [\n        {\n          \"phone_number\": \"+31002666661\",\n          \"phone_tech_type\": \"1\",\n          \"extension\": \"1\"\n        }\n      ],\n      \"email\": \"tests@booking.com\"\n    }\n  ]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-body-1","__idx":17},"children":["Response body"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following is a response body example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"/connectivity/docs/code/content-api-modules/POST-create-contact-details-rs.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n  \"warnings\": [],\n  \"meta\": {\n    \"ruid\": \"5rw83de5-54tt-45ad-a75c-af451309f764\"\n  }\n}\n\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-body-elements-1","__idx":18},"children":["Response body elements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table describes the response elements:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Element"},"children":["Element"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Attribute"},"children":["Attribute"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notes"},"children":["Notes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["warnings"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains any warnings in the response."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["meta"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains metadata information about the response."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ruid"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the unique request ID."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You can share this ID with Booking.com customer support when you run into an issue. This can help in understanding what went wrong."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"retrieving-contact-details","__idx":19},"children":["Retrieving contact details"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET\nhttps://supply-xml.booking.com/contacts-api/properties/{propertyID}/contacts\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET contacts-api"]}," endpoint along with the property ID to retrieve the contact details created for the property."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"header-parameter-2","__idx":20},"children":["Header parameter"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table describes the elements you can add in the header:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Header"},"children":["Header"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required/  Optional"},"children":["Required/",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Optional"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notes"},"children":["Notes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Accept-Version"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specify the version number to get the API functionality specific to that version."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Currently supports the value:  1.0"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"path-parameter-2","__idx":21},"children":["Path parameter"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table describes the elements you can add in the path:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required/  Optional"},"children":["Required/",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Optional"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notes"},"children":["Notes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["{",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["propertyID"]},"} value"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specify the unique ID of the property to retrieve the contact details."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"query-parameter","__idx":22},"children":["Query parameter"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table describes the elements you can add in the query:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required/  Optional"},"children":["Required/",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Optional"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notes"},"children":["Notes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["no_language_fallback"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Controls language fallback in the GET response."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Default: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]},". Allowed values: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]},". If omitted or set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]},", the API falls back to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["en-gb"]}," when preferred language is not set. If set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]},", fallback is skipped and can return ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," for the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["language_code"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-body-2","__idx":23},"children":["Response body"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following is a response body example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"/connectivity/docs/code/content-api-modules/GET-contact-details-rs.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n  \"data\": {\n    \"contacts\": [\n      {\n        \"contact_profiles\": [\n          {\n            \"type\": \"reservations\"\n          }\n        ],\n        \"contact_id\": 396227214,\n        \"address\": {\n          \"city_name\": \"Amsterdam\",\n          \"country_code\": \"NL\",\n          \"postal_code\": \"1011 DL\",\n          \"address_line\": \"New Straat 123\",\n          \"language_code\": \"en-gb\"\n        },\n        \"contact_person\": {\n          \"gender\": \"male\",\n          \"name\": \"Bensen Jill\",\n          \"job_title\": \"Administration Employee\",\n          \"language_code\": \"en-gb\"\n        },\n        \"phones\": [\n          {\n            \"phone_number\": \"+31000666661\",\n            \"phone_tech_type\": 1,\n            \"extension\": \"1\"\n          }\n        ],\n        \"email\": \"tests2@booking.com\"\n      },\n      {\n        \"contact_profiles\": [\n          {\n            \"type\": \"invoices\"\n          }\n        ],\n        \"contact_id\": 395775571,\n        \"address\": {\n          \"city_name\": \"Amsterdam\",\n          \"country_code\": \"NL\",\n          \"postal_code\": \"1011 DL\",\n          \"address_line\": \"New Straat 123\",\n          \"language_code\": \"en-gb\"\n        },\n        \"contact_person\": {\n          \"gender\": \"female\",\n          \"name\": \"Lucy Gilean\",\n          \"job_title\": \"Administration Employee\",\n          \"language_code\": \"en-gb\"\n        },\n        \"phones\": [\n          {\n            \"phone_number\": \"+31002666661\",\n            \"phone_tech_type\": 1,\n            \"extension\": \"1\"\n          }\n        ],\n        \"email\": \"tests@booking.com\"\n      },\n      {\n        \"contact_profiles\": [\n          {\n            \"type\": \"general\"\n          }\n        ],\n        \"contact_id\": 395775570,\n        \"address\": {\n          \"city_name\": \"Amsterdam\",\n          \"country_code\": \"NL\",\n          \"postal_code\": \"1011 DL\",\n          \"address_line\": \"New Straat 123\",\n          \"language_code\": \"en-gb\"\n        },\n        \"contact_person\": {\n          \"gender\": \"male\",\n          \"name\": \"Kevin Mcmartin\",\n          \"job_title\": \"General Manager\",\n          \"language_code\": \"en-gb\"\n        },\n        \"phones\": [\n          {\n            \"phone_number\": \"+31002666661\",\n            \"phone_tech_type\": 1,\n            \"extension\": \"1\"\n          }\n        ],\n        \"email\": \"tests@booking.com\"\n      },\n      {\n        \"contact_profiles\": [\n          {\n            \"type\": \"parity\"\n          }\n        ],\n        \"contact_id\": 396227126,\n        \"address\": {\n          \"city_name\": \"Amsterdam\",\n          \"country_code\": \"NL\",\n          \"postal_code\": \"1011 DL\",\n          \"address_line\": \"New Straat 123\",\n          \"language_code\": \"en-gb\"\n        },\n        \"contact_person\": {\n          \"gender\": \"female\",\n          \"name\": \"Waddington Hommes\",\n          \"job_title\": \"Administration Employee\",\n          \"language_code\": \"en-gb\"\n        },\n        \"phones\": [\n          {\n            \"phone_number\": \"+31000666661\",\n            \"phone_tech_type\": 1,\n            \"extension\": \"1\"\n          }\n        ],\n        \"email\": \"tests1@booking.com\"\n      }\n    ]\n  },\n  \"meta\": {\n    \"ruid\": \"149r05d7-e256-3689-a0f5-rt3416851256\"\n  }\n}\n\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-body-elements-2","__idx":24},"children":["Response body elements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following table describes the response elements:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Element"},"children":["Element"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Attribute"},"children":["Attribute"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notes"},"children":["Notes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Root element"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contacts"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains contact information."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">>"]},"  ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contact_profile_type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains the contact type."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enumerated string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the type of contact."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enumerated string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contact_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains a unique identifier for the contact"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["New field."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains the address details of the contact including country, city and postal code details."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["city_name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the name of the city, town, or village."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["state_prov_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains the State/province details."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the two-letter country code."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enumerated string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["postal_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the postal/zip code."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address_line"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the full street name and number."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["language_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the Booking.com Language code for the address details."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enumerated string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contact_person"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains the contact person's name, gender, spoken language and job title."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["language_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the contact's spoken language(s)."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enumerated string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gender"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the contact's gender."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enumerated string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the contact person's full name."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["job_title "]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the contact person's job title code."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enumerated string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phone"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains the phone number information."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phone_number"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the international phone number."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phone_tech_type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the type of phone line/device."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enumerated string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["extension"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The extension number that must be dialled in addition to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phone_number"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains the email address details."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["meta"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contains metadata information about the response."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[">"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ruid"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Specifies the unique request ID."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["You can share this ID with Booking.com customer support when you run into an issue. This can help in understanding what went wrong."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"quick-actions","__idx":25},"children":["Quick Actions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"→ To learn more about the Contacts API use cases, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/contacts-api/contacts-api-usecases/"},"children":["Contacts API implementation use cases."]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"→ To troubleshoot Contacts API errors, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/contacts-api/troubleshooting-contacts-api/"},"children":["Troubleshooting Contacts API error responses."]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"→ To create and manage a property, see the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/connectivity/docs/property-api/implementing-property-api-ga"},"children":["Property Details API."]}]}]},"headings":[{"value":"Managing contact details","id":"managing-contact-details","depth":1},{"value":"Creating contact details","id":"creating-contact-details","depth":2},{"value":"What are contact profile types?","id":"what-are-contact-profile-types","depth":3},{"value":"API validations","id":"api-validations","depth":3},{"value":"Header parameter","id":"header-parameter","depth":3},{"value":"Path parameter","id":"path-parameter","depth":3},{"value":"Request body parameters","id":"request-body-parameters","depth":3},{"value":"Contact Profile Types","id":"contact-profile-types","depth":3},{"value":"Request body","id":"request-body","depth":3},{"value":"Response body","id":"response-body","depth":3},{"value":"Response body elements","id":"response-body-elements","depth":3},{"value":"Overwriting contact details","id":"overwriting-contact-details","depth":2},{"value":"API validations","id":"api-validations-1","depth":3},{"value":"Header parameter","id":"header-parameter-1","depth":3},{"value":"Path parameter","id":"path-parameter-1","depth":3},{"value":"Request body parameters","id":"request-body-parameters-1","depth":3},{"value":"Request body","id":"request-body-1","depth":3},{"value":"Response body","id":"response-body-1","depth":3},{"value":"Response body elements","id":"response-body-elements-1","depth":3},{"value":"Retrieving contact details","id":"retrieving-contact-details","depth":2},{"value":"Header parameter","id":"header-parameter-2","depth":3},{"value":"Path parameter","id":"path-parameter-2","depth":3},{"value":"Query parameter","id":"query-parameter","depth":3},{"value":"Response body","id":"response-body-2","depth":3},{"value":"Response body elements","id":"response-body-elements-2","depth":3},{"value":"Quick Actions","id":"quick-actions","depth":2}],"frontmatter":{"title":"Managing contact details","description":"Use the Contacts API to create, update, retrieve, and delete property contact details including general, reservations, and invoices contact profiles.","keywords":{"includes":["contact_profiles","contacts-api/properties/{propertyid}/contacts","no_language_fallback","contacts-api/properties/{propertyID}/contacts","general","reservations","invoices","site_content","central_reservations"]},"seo":{"title":"Managing contact details"}},"lastModified":"2026-06-22T12:29:42.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/connectivity/docs/content-api-modules/contacts-api/implementing-contacts-api","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}