---
title: "Respond to an Interaction"
method: POST
path: "/locations/reviews/respond"
tags: ["Reviews", "Interactions"]
---

# Respond to an Interaction

`POST /locations/reviews/respond`

## Request

- Base URL: `https://api.synup.com/api/v4`
- URL: `https://api.synup.com/api/v4/locations/reviews/respond`
- Auth: none required
- TypeScript: <https://skmtc.dev/synup/apis/synup-api/docs/locations/reviews/respond/post.ts> (a function with typed inputs; its response is checked against the schema)

This API posts a response to a specific interaction on the respective partner site (e.g., Google, Facebook, Yelp).

    **Behavior:**
- The response is posted directly to the platform where the interaction originated.
- Some platforms may have moderation policies that affect response visibility.
- Supports text-based responses; some platforms may allow limited formatting.
- Ensures responses comply with platform-specific guidelines.

## Headers

- `Authorization` string, required

## Request body

- object
  - `interactionId` string, uuid, required: ID of the interaction to respond to
  - `responseContent` string, required: Response text content

## Response `200`

Response successfully posted

- object
  - `data` object
    - `respondToInteraction` object
      - `interaction` ResponseInteraction
        - `interactionId` string, uuid: Parent interaction ID for the response
        - `source` string: URL of the interaction site
        - `content` string: Interaction response content
        - `authorName` string, nullable: Name of person who responded
        - `authorAvatar` string, nullable: URL of response author's image
        - `authorUrl` string, nullable: URL of response author's profile
        - `date` string, date-time: Response timestamp
        - `interactionStatus` 'Created' | 'Completed' | 'Confirmed' | 'Failed': Status of the response: * Created - Initial creation * Completed - Posted to partner site * Confirmed - Verified on partner site * Failed - Response posting failed

---

[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)