Listings APIListings API
Get API keySign in
POST/api/v4/locations/reviews/respond

Respond to an interaction

Posts a public response to a review or interaction on its source platform.

Requires an API key. See Authentication for header format and key rotation.

Parameters

Body

NameTypeRequiredDescription
interactionIdstringrequiredID of the interaction to respond to — a raw numeric ID or Base64-encoded Relay ID (the `id` from the interactions list).
responseContentstringrequiredText content of the response to post.
respondedWithstringoptionalResponse-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, Yelp, 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": "<interactionId>",
    "responseContent": "<responseContent>",
    "respondedWith": "<respondedWith>"
  }'
Run in playground