post https://api.zenoti.com/v1/appointments//feedbacks
This API inserts a guest's feedback (which has been collected by using a third-party software) on a specific appointment into Zenoti.
For example, an organization uses a third-party software to collect guests' feedback on their appointments. You can then use this API to insert the collected guest feedback from that third-party software into Zenoti.
You must specify appropriate data for the appointment_group_id parameter.
Request Details
| Name | Type | Description |
|---|---|---|
| comments | string | Feedback comments provided by the guest for the specific appointment. |
| rating | integer | Star-rating given by the guest for the appointment. The limit of the rating (whether 5 or 10) depends on the feedback setting of the organization (Admin > Organization > Organizations > Settings > Feedback). |
| apply_for_group_invoice | boolean | If true, the guest's same feedback is applied for the complete group or individual appointment. If false, the same feedback is not considered for the entire group or individual appointment. |
Response Details
| Name | Type | Description |
|---|---|---|
| success | boolean | If true, the guest's feedback on the specified appointment is successfully inserted into Zenoti. |
| Message | string | Indicates that an error has occurred, and the guest's feedback on the specified appointment is not inserted into Zenoti. For more information on the various error messages, the respective error codes, and their description, refer the Error Message Details table below. |
Error Message Details
| Error Message | Error Code | Description |
|---|---|---|
| Invalid appointment group identifier | 502 | If the appointment_group_id is not provided. |
| Appointment group identifier is not found | 410 | If an invalid appointment_group_id is specified. |
| cannot access | 438 | If a Zenoti user who does not have the required permissions enters the feedback. |
| Feedback has already been given for this appointment | 4020 | If the feedback has already been provided for the appointment. |
| Invalid Input data | 502 | If the organization uses the older version (v1) of the feedback tool. |
| Please Enter a Valid Rating | 502 | If a valid integer value is not provided as the star-rating. |
| Ëxception message | 502 | If any other type of error occurs. |