New review received for a location

Webhook

POST

interaction.review

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.

Request

Header Params

Body Params application/json

Example

{
    "event": "interaction.review",
    "timestamp": "2026-06-16T05:25:52Z",
    "account_id": 10002,
    "location_id": "700001",
    "data": {
        "interaction": {
            "id": "aaaaaaaa-1111-2222-3333-bbbbbbbbbbbb",
            "type": "Review",
            "content": "From a parent's perspective, nothing matters more than knowing your child is happy and safe. Thank you for the wonderful care you provide!",
            "rating": 10,
            "author_name": "Alex Johnson",
            "author_avatar": "https://lh3.googleusercontent.com/a/placeholder-avatar",
            "date": "2026-06-15T14:58:43.540667+00:00",
            "source": "maps.google.com",
            "parent_id": null,
            "interaction_request_id": "cccccccc-dddd-eeee-ffff-000000000000",
            "title": null,
            "permalink": "https://maps.google.com/maps?cid=00000000000000000001",
            "category": "Review",
            "interaction_status": null
        }
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://your-api-server.com' \
--header 'X-Synup-Signature: sha256=Base64Signature==' \
--header 'Content-Type: application/json' \
--data '{
    "event": "interaction.review",
    "timestamp": "2026-06-16T05:25:52Z",
    "account_id": 10002,
    "location_id": "700001",
    "data": {
        "interaction": {
            "id": "aaaaaaaa-1111-2222-3333-bbbbbbbbbbbb",
            "type": "Review",
            "content": "From a parent'\''s perspective, nothing matters more than knowing your child is happy and safe. Thank you for the wonderful care you provide!",
            "rating": 10,
            "author_name": "Alex Johnson",
            "author_avatar": "https://lh3.googleusercontent.com/a/placeholder-avatar",
            "date": "2026-06-15T14:58:43.540667+00:00",
            "source": "maps.google.com",
            "parent_id": null,
            "interaction_request_id": "cccccccc-dddd-eeee-ffff-000000000000",
            "title": null,
            "permalink": "https://maps.google.com/maps?cid=00000000000000000001",
            "category": "Review",
            "interaction_status": null
        }
    }
}'

Responses

🟢200

application/json

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.

Bodyapplication/json

Example

{}

Modified at 2026-07-22 07:09:29

Directory listing synced (success/incomplete)

New response to a review received