Post or edit a response

Write a reply to a review and queue it for posting to the live review site. Call it again with new text to edit a reply you've already posted. Use this whenever you're answering a review, whether you wrote the text yourself or took it from an AI draft. Text can be at most 4,000 characters; a couple of sites have tighter limits, and the error will tell you. It won't post if the site isn't authorized (422 naming connection or posting), if the text is identical to the current reply (400), or if your plan's response allowance is used up (402, with the limit details in X-Feature headers).

Prerequisites: a bearer token and the review's id (review_id). The review site must be connected for the location, with posting available for that site. Optional: the id of the AI draft you used (ai_response_id).

Authentication: Partner or Account token. The review must be inside your own account tree (a Partner token reaches any location under the partner, an Account token only its own); otherwise 422.

Rate limit: none.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
integer
required
Defaults to 279309

The review to respond to. Must exist and be inside your account tree.

string
required
Defaults to Thank you for the kind review! We are glad you enjoyed your visit and hope to see you again soon.

The response text. At most 4,000 characters. OpenTable allows at most 400 characters, not counting spaces; Optspot needs 80 to 160 characters. Must differ from the current reply (case and surrounding spaces are ignored).

integer | null
Defaults to 39

The id of the AI draft the text is based on (ai_review_response_id from Draft a response with AI). Must exist. It's linked only when the draft belongs to the same review; otherwise it's ignored.

string | null
deprecated

Not used. The draft's text is read from ai_response_id.

Responses

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json