• Create contact
• Update contact
• List and filter contacts

The endpoint we use is:https://app.hoteldatahub.io/api/v1/contacts/and the Swagger section is:https://app.hoteldatahub.io/swagger/#/contacts

1. Booking engine: The use of this endpoint from a booking engine allows retrieving the contact information of a guest who has made a reservation through the hotel or chain’s website. In this way, even before the guest arrives at the hotel, Fideltour already obtains their contact details and can use them to start communicating with the guest
   
2. PMS: Information from a PMS is highly valuable for Fideltour, as many data sources centralize their information in it. It also allows us to obtain contact information for other guests besides the reservation holder, increasing the size of our database thanks to this connection.
   
3. Wi-Fi and other platforms: In a hotel, there may be other platforms or cloud services that collect information about their users and can send it to Fideltour to enrich the database and improve marketing campaigns and informational communications about the hotel's services.

Available methods:

All the methods and filters available for working with contacts can be consulted here.

1. GET: Query of data from one or more contacts
2. POST: Creating a new contact
3. PATCH: Updating the data of an existing contact

Parameter table:

Examples

:

Here are some examples of creating, updating and viewing contacts.

Petition (POST-PATCH):

The following example shows a request to register (POST) or update (PATCH) the contactpablo@hdh.com.

Protocol: Http/1.1

Method: Post/Patch

Host/endpoint: https://app.hoteldatahub.io/api/v1/contacts/

Headers:

• Content-type: application/json
• Authorization: Token xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

BODY: An example is added below.

28. { {
29. "email":"pablo@hdh.com",
30. "email_status":0,
31. "birthday":"1976-04-18",
32. "phone1":"651442233",
33. "phone2":"12323",
34. "gender":2,
35. "address":"Calle the olive trees",
36. "province":"Madrid",
37. "town":"Madrid",
38. "zone":"Sun",
39. "post_code":"28013",
40. "language":"Es",
41. "country":"Es",
42. "name":"Pablo",
43. "surname":"Look",
44. "identification_document_type":1 1 1,
45. "identification_number":"01234567Z",
46. "source":1 1 1,
47. "notes":"Very demanding",
48. "work_place":"Palma",
49. "bussiness_name":"Customia",
50. "bussiness_address":"Street of industrial solutions 25",
51. "Fiscal_address":"Street of industrial solutions 25",
52. "custom_tags":[ [ [" VIP client","Tourist"],
53. "subscribed":false,
54. "is_active":true
55. }

Note: true and false Boolean values can also be sent as Integers 1 and 0.

Answer (POST/PATCH):

In casa of a 200 or 201 response, JSON received has the following structure

47. { {
48. "id":9999999,
49. "business_name":null,
50. "work_place":"Madrid",
51. "business_address":null,
52. "Fiscal_address":"Street of industrial solutions 25",
53. "language":"Es",
54. "country":"Es",
55. "created_at":"2022-01-01T12:12:12.654321",
56. "level_name":"",
57. "loyalty_card_number":null,
58. "name":"Pablo",
59. "surname":"Look",
60. "email":"pablo@hdh.com",
61. "email_status":0,
62. "phone1":"651442233",
63. "phone2":"12323",
64. "gender":2,
65. "identification_document_type":1 1 1,
66. "identification_number":"01234567Z",
67. "birthday":"1976-04-18",
68. "address":"Calle the olive trees",
69. "post_code":"07006",
70. "source":1 1 1,
71. "notes":"Very demanding",
72. "photo":null,
73. "subscribed":false,
74. "unsubscribe_reason":null,
75. "date_subscribed":"2022-01-01T12:12:12.654321",
76. "modification_date_subscribed":null,
77. "is_active":true,
78. "points":0,
79. "value":0,
80. "review":null,
81. "total_bookings":0,
82. "level_points":0,
83. "loyalty_custom_tag_timestamp":null,
84. "is_profile_completed":false,
85. "last_level_review":null,
86. "kicked_out_loyalty":null,
87. "province":1 1 1,
88. "town":2,
89. "zone":3,
90. "level":null,
91. "custom_tags":[ [ [4,5],
92. "hotels":[]
93. }

Request (GET):

The GET method allows the following:

• List contacts based on applied filters, which can be found at: See in swagger
• Get the data of a contact by providing its ID per URL parameter: https://app.hoteldatahub.io/api/v1/contacts/{id}/

Protocol: http/1.1

Method: get

Host/endpoint: https://app.hoteldatahub.io/api/v1/contacts/?email__iexact=pablo@hdh.com

Headers:

• Authorization: Token xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Body:In this case, as a GET-type method, we do not include data in the body of the request, as they are included in the URL.

Answer (GET):

54. { {
55. "count":1 1 1,
56. "next":null,
57. "previous":null,
58. "results":[ [ [
59. { {
60. "id":7778735,
61. "business_name":null,
62. "work_place":"Palma",
63. "business_address":null,
64. "Fiscal_address":"Street of industrial solutions 25",
65. "language":"Es",
66. "country":"Es",
67. "created_at":2022-12-21T16:40:20.681955",
68. "level_name":"",
69. "loyalty_card_number":null,
70. "name":"Pablo",
71. "surname":"Look",
72. "email":"pablo@hdh.com",
73. "email_status":0,
74. "phone1":"651442233",
75. "phone2":"12323",
76. "gender":2,
77. "identification_document_type":1 1 1,
78. "identification_number":"01234567Z",
79. "birthday":"1976-04-18",
80. "address":"Calle the olive trees",
81. "post_code":"07006",
82. "source":1 1 1,
83. "notes":"Very demanding",
84. "photo":null,
85. "subscribed":false,
86. "unsubscribe_reason":null,
87. "date_subscribed":2022-12-21T16:40:20.681955",
88. "modification_date_subscribed":null,
89. "is_active":true,
90. "points":0,
91. "value":0,
92. "review":null,
93. "total_bookings":0,
94. "level_points":0,
95. "loyalty_custom_tag_timestamp":null,
96. "is_profile_completed":false,
97. "last_level_review":null,
98. "kicked_out_loyalty":null,
99. "province":1 1 1,
100. "town":2,
101. "zone":3,
102. "level":null,
103. "custom_tags":[ [ [4,5],
104. "hotels":[]
105. }
106. ]
107. }