---
title: "Create a comment"
method: POST
path: "/social/{connection_id}/comment"
tags: ["social", "comment"]
---

# Create a comment

`POST /social/{connection_id}/comment`

## Request

- Base URL: `https://api.unified.to`
- URL: `https://api.unified.to/social/{connection_id}/comment`
- Auth: API key in header `authorization`
- TypeScript: <https://skmtc.dev/unified/apis/unified-to-api/docs/social/:connection_id/comment/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a SocialComment. Provide the unified SocialComment fields in the request body; they are mapped to the provider's API. Returns the created SocialComment.

## Path parameters

- `connection_id` string, required

## Query parameters

- `fields` string[]
- `raw` string

## Request body

- SocialComment
  - `id` string: Unique identifier for the comment
  - `created_at` string, date-time: When the comment was posted (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `updated_at` string, date-time: When the comment was last edited, when the provider reports it (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `post_id` string: The post (or video) the comment belongs to
  - `parent_id` string: Set when this comment is a reply; the id of the comment being replied to
  - `author_identifier` string: Provider id of the commenter (not a Unified id)
  - `author_name` string: Display name of the commenter
  - `author_username` string: Handle / username of the commenter
  - `author_avatar_url` string: Avatar URL of the commenter
  - `content` string: The comment text
  - `url` string: Permalink to the comment, when available
  - `is_hidden` boolean: True if the comment is hidden or held for moderation
  - `metrics` PropertySocialCommentMetrics
    - `like_count` number: Number of likes on the comment
    - `reply_count` number: Number of replies to the comment
  - `raw` object: Raw data from integration

## Response `200`

Successful

- SocialComment
  - `id` string: Unique identifier for the comment
  - `created_at` string, date-time: When the comment was posted (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `updated_at` string, date-time: When the comment was last edited, when the provider reports it (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `post_id` string: The post (or video) the comment belongs to
  - `parent_id` string: Set when this comment is a reply; the id of the comment being replied to
  - `author_identifier` string: Provider id of the commenter (not a Unified id)
  - `author_name` string: Display name of the commenter
  - `author_username` string: Handle / username of the commenter
  - `author_avatar_url` string: Avatar URL of the commenter
  - `content` string: The comment text
  - `url` string: Permalink to the comment, when available
  - `is_hidden` boolean: True if the comment is hidden or held for moderation
  - `metrics` PropertySocialCommentMetrics
    - `like_count` number: Number of likes on the comment
    - `reply_count` number: Number of replies to the comment
  - `raw` object: Raw data from integration

## Changes

- **2026-11-09** `b81703b69915`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/unified/apis/unified-to-api/changes/social/:connection_id/comment/post.md)

---

[API](https://skmtc.dev/unified/apis/unified-to-api.md) - [All operations](https://skmtc.dev/unified/apis/unified-to-api/llms.txt) - [OpenAPI document](https://skmtc.dev/unified/apis/unified-to-api/revisions/b81703b69915?raw)