POpostproxy
Profile Comments

Reply to a profile comment

Creates a reply to an existing review. The reply is stored immediately with status pending and external_id null; it is then published to the platform. Top-level comments cannot be created — the request returns 422 if parent_id is missing.

post/api/profiles/{profile_id}/comments

Request

  • Base URL
    https://api.postproxy.dev
  • URL
    https://api.postproxy.dev/api/profiles/{profile_id}/comments
  • Auth
    HTTP bearer

Query parameters

profile_group_idstring

Profile group context for the request. Optional when the API key is scoped to a profile group (that group is used automatically); with a full-access key, defaults to the first profile group in the account.

Headers

Idempotency-Keystring

Optional idempotency key (up to 255 characters; a UUID is ideal). Retrying a successful write with the same key replays the original response (with an Idempotent-Replay: true header) instead of executing again. Stored responses are kept for 24 hours; only 2xx responses are stored.

Request body

parent_idstring required

Postproxy ID or external ID of the review being replied to

bodystring required

Reply body. (The legacy text parameter is still accepted as an alias.)

Response

Reply created with status pending and external_id null; published asynchronously.

idstring

Postproxy comment ID (hashid)

external_idstring nullable

Platform's native resource ID (null while a reply is pending publication)

parent_external_idstring nullable

External ID of parent review (null for top-level reviews)

placement_idstring

Location path (e.g. accounts/X/locations/Y)

bodystring nullable

Comment/review text. Google Business reviews can be star-only: body is null while platform_data.star_rating is still populated.

status'synced' | 'pending' | 'published' | 'failed' | 'failed_waiting_for_retry' | 'deleted'
errorstring nullable

Error summary if an outgoing reply failed (null otherwise)

author_usernamestring nullable

Display name of reviewer (null for your own replies)

author_avatar_urlstring nullable

Profile image URL

platform_dataobject nullable

Platform-specific metadata (e.g. star_rating, update_time for Google reviews; recommendation_type for Facebook recommendations)

permalinkstring nullable

URL to the comment on the platform (the location's reviews page on Google or the Page's reviews tab on Facebook — shared by all reviews and replies on that location / Page; null if unavailable)

posted_atstring nullable

ISO 8601 timestamp of platform posting

created_atstring

ISO 8601 timestamp of record creation

repliesProfileComment[] circular

Changes

No recorded changes to this operation across all 1 revision of this API.