Update Contact
PUT {{baseUrl}}/contacts/:contact_uid
This API is called to update an existing contact.
Contact Functionality:
To amend an existing contact, please send the corresponding
contact_uid
in both the path as well as the body parameter with the amended data. In this case the latest request takes precedence and therefore the data is always overwritten, not merged.TIP: The contact details will be returned on every request. Therefore you are able to merge and combine all data on your side manually.
Please note that this API will not amend the contact details of individual orders by default. To amend the contact details of an order, please pass the corresponding order references as well.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
order_reference | string | By default, previous orders will not be amended. If you would like to update existing orders to the latest contact version, please include these here as well. | |
If the contact was not linked to the order yet, it will be added. |
Request Body
{"data"=>{"contact"=>{"contact_external_uid"=>"{{$randomUUID}}", "contact_name_first"=>"{{$randomFirstName}}", "contact_name_last"=>"{{$randomLastName}}", "contact_email"=>"{{$randomExampleEmail}}", "contact_phone"=>"{{$randomPhoneNumber}}", "contact_mobile"=>"{{$randomPhoneNumber}}", "contact_language"=>"{{$randomLocale}}", "contact_nationality"=>"Dutch", "contact_flight_number"=>"KL 445", "contact_birth_place"=>"{{$randomCity}}", "contact_passport"=>"string", "contact_gender"=>"MALE", "contact_age"=>19, "contact_address"=>{"name"=>"Start of the walking Tour / My house / Office", "street"=>"{{$randomStreetName}}", "city"=>"{{$randomCity}}", "postal_code"=>"1011 PN", "region"=>"Noord-Holland", "country"=>"{{$randomCountry}}", "country_code"=>"{{$randomCountryCode}}", "place_id"=>"ChIJrTLr-GyuEmsRBfy61i59si0", "latitude"=>"{{$randomLatitude}}", "longitude"=>"{{$randomLongitude}}", "notes"=>"It's on the fourth floor"}}}}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string |
RESPONSES
status: OK
{"api_version":"3.4.0","data":{"items":[{"contact_uid":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_external_uid":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_number":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_type":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_title":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_name_first":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_name_last":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_email":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_phone":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_mobile":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_language":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_nationality":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_flight_number":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_loyalty_number":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_birth_place":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_birth_date":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_passport":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_gender":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_age":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_room_number":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_website":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_classification":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_address":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_notes":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_custom_fields":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},{"contact_uid":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_external_uid":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_number":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_type":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_title":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_name_first":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_name_last":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_email":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_phone":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_mobile":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_language":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_nationality":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_flight_number":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_loyalty_number":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_birth_place":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_birth_date":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_passport":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_gender":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_age":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_room_number":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_website":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_classification":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_address":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_notes":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"contact_custom_fields":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}}],"kind":"location"}}