Reviews and social posts

Reviews and posts depend on a linked profile. See Social profile connections.

Reviews

Task	Endpoint
List reviews	GET Review list
Read one review	GET Review
Read replies to a review	GET Review comments
Reply	POST Review comment
Edit a reply	PUT Review comment

GET Review list takes ids and contextType (Location or Company). Useful filters:

• socialPortal: restrict to a portal
• answeredStatus: false returns reviews without an owner reply
• minRating and maxRating
• take (max 500), skip, sortColumn, sortDirection

POST /social/reviewComment/{reviewId}

{ "comment": "Thank you for your feedback!" }

To answer many reviews, read existing replies for several reviews at once with GET Bulk review comments.

Social posts

Step	Endpoint
1. Get portals that support posts	GET Social portals with portalType=post
2. Check settings for the locations	GET Post settings
3. Create the post	POST Social post
4. Follow up	GET Social posts

POST /social/post takes contextIds, contextType and socialPortal as query parameters. The body holds the content:

POST /social/post?contextIds=1001&contextType=Location&socialPortal=GoogleMyBusiness

{
  "postContent": "Fresh bread every morning.",
  "date": "2026-11-05",
  "time": "09:00",
  "postTopicType": "STANDARD",
  "ctaType": "LEARN_MORE",
  "ctaUrl": "https://example.com/bread"
}

A date in the future schedules the post. Call to action and topic types are only available for Google. Leave ctaUrl unset when ctaType is CALL. Facebook accepts up to 10 images, other portals one.

Change or remove a post

Task	Endpoint
Edit a scheduled post	PUT Social post
Delete a scheduled post	DELETE Social post
Retry a failed post	Retry Social post
Cancel a failed post	Cancel Social post

Edit and delete only work before the scheduled date.

Comments on posts

Task	Endpoint
Read comments	GET Post comments
Read replies	GET Comment replies
Comment	POST Post comment
Delete a comment or reply	DELETE Comment / DELETE Reply