New response to a review received

Webhook

POST

interaction.response

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.

Request

Header Params

Body Params application/json

Example

{
    "event": "interaction.response",
    "timestamp": "2026-06-16T04:40:38Z",
    "account_id": 10002,
    "location_id": "700002",
    "data": {
        "interaction": {
            "id": "dddddddd-eeee-ffff-0000-111111111111",
            "type": "Response",
            "content": "Thank you for the kind words! We truly appreciate your feedback and look forward to serving you again.",
            "rating": null,
            "author_name": "Owner",
            "author_avatar": null,
            "date": "2022-03-22T18:22:28.266579+00:00",
            "source": "maps.google.com",
            "parent_id": "aaaaaaaa-1111-2222-3333-bbbbbbbbbbbb",
            "interaction_request_id": "eeeeeeee-ffff-0000-1111-222222222222",
            "title": "Response from owner",
            "permalink": "https://maps.google.com/maps?cid=00000000000000000002",
            "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.response",
    "timestamp": "2026-06-16T04:40:38Z",
    "account_id": 10002,
    "location_id": "700002",
    "data": {
        "interaction": {
            "id": "dddddddd-eeee-ffff-0000-111111111111",
            "type": "Response",
            "content": "Thank you for the kind words! We truly appreciate your feedback and look forward to serving you again.",
            "rating": null,
            "author_name": "Owner",
            "author_avatar": null,
            "date": "2022-03-22T18:22:28.266579+00:00",
            "source": "maps.google.com",
            "parent_id": "aaaaaaaa-1111-2222-3333-bbbbbbbbbbbb",
            "interaction_request_id": "eeeeeeee-ffff-0000-1111-222222222222",
            "title": "Response from owner",
            "permalink": "https://maps.google.com/maps?cid=00000000000000000002",
            "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

New review received for a location

Listing connected