/api/v4/locations/reviews/respondRespond to an interaction
Posts a public response to a review or interaction on its source platform.
Parameters
Body
| Name | Type | Required | Description |
|---|---|---|---|
| interactionId | string | required | UUID of the interaction to respond to. Take it from an interaction's `id` or `interactionId`, which are the same value. It is a plain UUID, with no numeric or Base64 Relay form. |
| responseContent | string | required | Text content of the response to post. |
| respondedWith | string | optional | Response-template ID to attribute the reply to, if it was generated from a template. |
Sample request
Ready-to-paste body. Replace placeholder IDs and values with yours.
{ "interactionId": "9e26d2a8-a6ed-42ea-8454-47d1c92ea841", "responseContent": "Thank you for visiting Jenny Home: we're glad you enjoyed your experience!"}Responses
200Response accepted and queued for posting. `data.respondToInteraction.interaction` holds the created response.
{ "data": { "respondToInteraction": { "interaction": { "id": "2090753a-ece6-4837-8336-8494ad308523", "interactionId": "9e26d2a8-a6ed-42ea-8454-47d1c92ea841", "content": "Thank you for visiting Jenny Home: we're glad you enjoyed your experience!", "interactionStatus": "CREATED", "editedResponse": false }, "errors": null } }}401Unauthenticated, missing or invalid API key.
Common errors
- SY50121: Google Reviews accept only a single owner reply per review; a second response is rejected.
Posts a response to a review or interaction on its originating platform (e.g. Google, Facebook). The response is submitted asynchronously: interactionStatus is CREATED immediately and transitions to COMPLETED or CONFIRMED once the platform acknowledges it (or FAILED, see the response status flow).
Not every platform supports owner responses. Check canRespond on the interaction object before calling. Google Reviews accept only one reply per review (a repeat attempt returns SY50121); use Edit a response to change an existing reply instead of posting a new one.
Use case: auto-reply to new 5-star reviews
To thank happy reviewers automatically, poll List interactions with ratingFilters=[5] and responseStatus=["PENDING"], then for each returned node whose canRespond is true, POST its id as interactionId with your responseContent:
{ "interactionId": "9e26d2a8-a6ed-42ea-8454-47d1c92ea841", "responseContent": "Thank you for visiting Jenny Home: we're glad you enjoyed your experience!"}Because posting is asynchronous, re-fetch the interaction via Get interactions by IDs to confirm the response reached COMPLETED/CONFIRMED rather than assuming success from the 200.
curl -X POST 'https://listingsapi.com/api/v4/locations/reviews/respond' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "interactionId": "9e26d2a8-a6ed-42ea-8454-47d1c92ea841", "responseContent": "Thank you for visiting Jenny Home: we're glad you enjoyed your experience!" }'