NOTE: We recommend using HTTP POST method for all calls.  This allows you to send parameters including the token in the payload of the message which increases security. 


The evaluation entity in PEAK 15 is used as a way to capture an feedback on a trip taken by a guest. Evaluations can be done as one evaluation per booking that is linked to the booking and the contact that is the client on the booking or one evaluation per guest that is linked to the booking and the contact record of the guest.


  • Create an Evaluation
  • Adding Leader Ratings
  • Adding Vendor Ratings
  • Adding Trip Activity Ratings
  • Adding Destination Interest Ratings
  • Adding Trip Activity of Interest Ratings
  • Page Redirect
  • Return All IDs




Create an Evaluation

The following post shows a basic evaluation that will be linked to the contact that is the client on the booking


POST /beacon/service.svc/insert/complex/evaluation HTTP/1.1
Host: data.peak15systems.com
Content-Type: application/x-www-form-urlencoded

token=your-token-here
&p15_evaluation.p15_bookingid=your-bookingid-here
&p15_evaluation.p15_score_dec=your-decimalvalue-here
&p15_evaluation.p15_comments=your-comments-here
&p15_evaluation.p15_suggestions=your-suggestions-here


This post shows a basic evaluation that will be linked to the contact for the guest record


POST /beacon/service.svc/insert/complex/evaluation HTTP/1.1
Host: data.peak15systems.com
Content-Type: application/x-www-form-urlencoded

token=your-token-here
&p15_evaluation.p15_guestid=your-guestid-here
&p15_evaluation.p15_score_dec=your-decimalvalue-here
&p15_evaluation.p15_comments=your-comments-here
&p15_evaluation.p15_suggestions=your-suggestions-here


Adding Leader Ratings


You can also capture ratings for leaders by including:


&p15_leaderrating.1.p15_leaderid=[contact name or ID]
&p15_leaderrating.1.p15_rating_dec=[decimal]
&p15_leaderrating.2.p15_leaderid=[contact name or ID]
&p15_leaderrating.2.p15_rating_dec=[decimal]


Note: The leader must be a contact in PEAK 15 and must have a contact type of Leader.


Adding Vendor Ratings


You can also capture ratings for vendors or companies by including:


&p15_vendorrating.1.p15_vendorid=[company name or ID]
&p15_vendorrating.1.p15_rating_dec=[decimal]
&p15_vendorrating.2.p15_vendorid=[company name or ID]
&p15_vendorrating.2.p15_rating_dec=[decimal]


Note: The vendor must be a company in PEAK 15.


Adding Trip Activity Ratings


You can capture ratings of individual activities from the trip by including:


&p15_activityrating.1.p15_tripactivityid=[activity name or ID]
&p15_activityrating.1.p15_rating=[int]
&p15_activityrating.2.p15_tripactivityid=[activity name or ID]
&p15_activityrating.2.p15_rating=[int]



Adding Destination Interest Ratings


You can capture how interested they are in traveling to specific destinations in the future by adding the following to your URL


&p15_destinterestrating.1.p15_destinationid=[destination name or ID]
&p15_destinterestrating.1.p15_rating=[int]
&p15_destinterestrating.2.p15_destinationid=[destination name or ID]
&p15_destinterestrating.2.p15_rating=[int]



Adding Trip Activity Interest Ratings


You can capture how interested they are in trips that feature specific activities in the future by adding the following to your URL


&p15_actinterestrating.1.p15_tripactivityid=[activity name or ID]
&p15_actinterestrating.1.p15_rating=[int]
&p15_actinterestrating.2.p15_tripactivityid=[activity name or ID]
&p15_actinterestrating.2.p15_rating=[int]



Page Redirect


Once you have tested your forms to ensure they are posting data to PEAK 15 correctly, you can use additional hidden form fields to define what pages on your site you’d like to send the submitter of the form in the event of a success or a failure.


&SuccessPage=http://domain.com/pg1.html
&Errorpage=http://domain.com/pg1.html



NOTE: You can't combine usage of returnallids and the successpage/error page attributes.


Return All IDs


By default, Beacon will return the GUID of the inquiry created. However, if you wish to get back both the GUID of the contact record and the inquiry record, then use:


&returnallids=true