Set Contact

You can set multiple contacts with different contact types but with the same contact details.

Endpoint

POST 

https://connect-sandbox.su-api.com/SUAPI/jservice/bdc/property/contact/set
-app-id: YOUR_APP_ID
Authorization: YOUR_API_KEY
Content-Type:application/json
Header
Type
Required
Description

app-id

string

Yes

Your application ID. Required for authentication.

Authorization

string

Yes

Your API key for authorization.

Content-Type

string

Yes

Must be set to application/json.

Attributes

hotel_id alphanumeric (Required)

The unique property ID as assigned by the provider upon creation of the property.

channel_hotel_id string (Required)

The unique id for the hotel on the specific channel.

contacts object (Required)

An array of contact objects containing contact details.

You must create one contact details for the General contact type.

Note that you can create at a maximum only one contact detail per property for the General contact type.

contact_profiles object (Required)

A list of profiles associated with the contact (e.g., invoices, general).

type enumerated string (Required)

Specify the contact type.

For a list of approved contact types, see Contact Profile Type.

address object

NOTE

The sub-attributes of the "address" object are required only when the "address" key is specified in the request. If the "address" key is omitted, these sub-attributes should not be included.

Contains the address details of the contact including country, city and postal code details.

You can set only one address per contact type.

city_name string (Required if address is specified)

The city name where the contact is located.

Any valid city name (e.g., "Wellington")

country_codeenumerated string (Required)

The ISO country code of the contact's location.

For more information on how to retrieve the country code details, see xml/countries endpoint.

Must be a valid ISO 3166-1 alpha-2 country code. e.g., "NL" for Netherlands

postal_code string (Required)

The postal code of the contact's location.

Make sure the postal code is relevant to the country specified in the country_code.

address_line string (Required)

The street address of the contact.

Should not contain abbreviations (such as "Rd." for "Road") and should not exceed 255 characters.

language_code enumerated string (Required)

The language code for the address.

For a list of supported language codes, see Booking.com Language Code table.

contact_person object

Details about the contact person.

gender enumerated string (Optional)

Gender of the contact person.

Accepts: Male, Female. Default: null.

To set as empty, omit the entire attribute (instead of specifying "").

name string (Required)

Full name of the contact person.

job_title enumerated string (Optional)

Job title of the contact person.

For a list of supported job titles and their code, see Booking.com Job Title Code.

By default, it is set to Unknown.

language_code string (Required)

Language code for the contact person (e.g., 'en-gb').

For a list of supported language codes, see Booking.com Language Code table.

phones array (Required)

List of phone numbers associated with the contact.

phone_number string (Required)

The actual phone number (all international phone numbers).

  • Follows the format: \+[0-9]+

  • The phone number is also validated based on the formatting rules of the specified country code.

phone_tech_type enumerated string (Required)

Technology type of the phone (for example, '1' for landline).

  • For a list of supported values, see Phone Technology Type Code.

  • PhoneTechType 3 can have at most 3 entries.

  • PhoneTechType 1 and 5 can have at most 1 entry.

  • Extension can only be provided for PhoneTechType 1.

extension string (Optional)

Extension number for the phone, if applicable.

Only accepted when phone_tech_type="1".

email string (Required)

Email address of the contact.

Make sure to specify email address in valid email format.

For example, test@abc.com.

Sample Request

{
   "hotel_id": "NT7",
   "channel_hotel_id": "12837615",
   "contacts": [
       {
           "contact_profiles": [
               {
                   "type": "invoices"
               }
           ],
           "address": {
               "city_name": "Amsterdam",
               "country_code": "NL",
               "postal_code": "1011 DL",
               "address_line": "New Straat 123",
               "language_code": "en-gb"
           },
           "contact_person": {
               "gender": "female",
               "name": "Waddington Bloem",
               "job_title": "Administration Employee",
               "language_code": "en-gb"
           },
           "phones": [
               {
                   "phone_number": "+31243611111",
                   "phone_tech_type": "1",
                   "extension": "1"
               }
           ],
           "email": "test@booking.com"
       },
       {
           "contact_profiles": [
               {
                   "type": "general"
               }
           ],
           "address": {
               "city_name": "Amsterdam",
               "country_code": "NL",
               "postal_code": "1011 DL",
               "address_line": "New Straat 456",
               "language_code": "en-gb"
           },
           "contact_person": {
               "gender": "male",
               "name": "Bensen Clay",
               "job_title": "Administration Employee",
               "language_code": "en-gb"
           },
           "phones": [
               {
                   "phone_number": "+31243611111",
                   "phone_tech_type": "1",
                   "extension": "1"
               }
           ],
           "email": "tests@booking.com"
       }
   ]
}

Response

Sample Success Response

{
   "Status": "Success",
   "Data": [],
   "Message": "Property Contact-Details Created Successfully"
}

Error

Sample Error Response 1

{
   "Errors": [
       {
           "Code": "400",
           "ShortText": "HotelCode: Invalid HotelCode ('NT711')"
       }
   ],
   "Status": "Fail"
}

Sample Error Response 2

{
   "Errors": [
       {
           "Code": "573",
           "ShortText": "channel-mapping not found for this property!"
       }
   ],
   "Status": "Fail"
}

Sample Error Response 3

{
   "Errors": [
       {
           "Code": "584",
           "ShortText": "contact_profiles: type is invalid or not found"
       }
   ],
   "Status": "Fail"
}

Sample Error Response 4

{
   "Status": "Fail",
   "Errors": [],
   "Message": "Access denied"
}

Response Body Elements

Status string

The status of the response.

Data object

The response data, the root element.

property_id string

Specifies the property ID that was created.

Message string

The message in the response.

Error array

Array that contains details about any errors that occurred during the API call. Each object in the Errors array contains the following properties:

Code string

Specific error code that helps identify the type of error.

ShortText string

Brief description of the error.

PreviousContact DetailsNextRetrieve Contact

Last updated

Was this helpful?