---
title: "New response to a review received"
method: POST
path: "interaction.response"
tags: ["Webhooks/Webhooks", "Webhooks"]
---

# New response to a review received

`POST interaction.response` (webhook)

**Event name:** `interaction.response`

Sent when Synup detects a new response to an existing review — including responses posted through Synup and responses detected directly on the platform. Responses arrive asynchronously, often well after the original review. Delivered to your Webhooks URL (Reviews webhook). Location-scoped. Use data.interaction.parent_id to link the response to the review it answers.

## Headers

- `X-Synup-Signature` string, required

## Payload

- object
  - `event` string: Dotted event name.
  - `timestamp` string: ISO-8601 datetime Synup detected and processed this interaction (UTC).
  - `account_id` integer: The Synup account that owns this location.
  - `location_id` string: Synup's numeric location ID, as a string.
  - `data` object
    - `interaction` object: The review or response.
      - `id` string: Synup's unique ID (UUID) for this interaction.
      - `type` string: "Response" for this event.
      - `content` string: Full text of the review.
      - `rating` integer: Always null — responses do not carry a rating.
      - `author_name` string: Name of the business or person who wrote the response (e.g. "Owner").
      - `author_avatar` string: Usually null for owner responses.
      - `date` string: ISO-8601 datetime the review was originally posted on the platform.
      - `source` string: Platform the review came from (e.g. "maps.google.com", "yelp.com").
      - `parent_id` string: The id (UUID) of the original review this response belongs to; use it to link back to a review you already received.
      - `interaction_request_id` string: Internal tracking ID (UUID) for the crawl request that surfaced this review.
      - `title` string: "Response from owner" when provided by the platform, otherwise null.
      - `permalink` string: Direct URL to the review on the original platform.
      - `category` string: "Review" — responses share the same category value as reviews.
      - `interaction_status` string: String or null.
  - `agency_account_id` integer: Present only when the account is managed by a parent agency account.

## Acknowledgement `200`

Acknowledge with any 2xx. A non-2xx (or timeout) is recorded as a failed delivery; failures are logged but not automatically retried at this time.

- object

---

[API](https://skmtc.dev/synup/apis/synup-api.md) - [All operations](https://skmtc.dev/synup/apis/synup-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synup/apis/synup-api/revisions/67de2d51c22e?raw)