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

# New review received for a location

`POST interaction.review` (webhook)

**Event name:** `interaction.review`

Sent when Synup detects a new review for one of your locations on any monitored platform (Google, Yelp, TripAdvisor, etc.). Delivered to your Webhooks URL (Reviews webhook — requires the reviews webhook permission). Location-scoped. Social-category interactions are not delivered.

## 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: "Review" for this event.
      - `content` string: Full text of the review.
      - `rating` integer: Reviewer rating on a normalized 1-10 scale (null for platforms without ratings). For Facebook Recommendations, 10 = positive (thumbs up), 2 = negative (thumbs down). Divide if you need a 1-5 scale.
      - `author_name` string: Name of the person who left the review.
      - `author_avatar` string: URL to the reviewer's profile photo; null if the platform provides none.
      - `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: Always null for reviews (used by responses to reference the original review).
      - `interaction_request_id` string: Internal tracking ID (UUID) for the crawl request that surfaced this review.
      - `title` string: Review title if provided; usually null for Google reviews.
      - `permalink` string: Direct URL to the review on the original platform.
      - `category` string: "Review" for standard reviews, "Recommendation" for Facebook Recommendations.
      - `interaction_status` string: Always null for reviews.
  - `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)