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, [e-mail].

---

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": "[phone]",
                   "phone_tech_type": "1",
                   "extension": "1"
               }
           ],
           "email": "[e-mail]"
       },
       {
           "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": "[phone]",
                   "phone_tech_type": "1",
                   "extension": "1"
               }
           ],
           "email": "[e-mail]"
       }
   ]
}

---

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.