CommentThreads: insert

Creates a new top-level comment. To add a reply to an existing comment, use the comments.insert method instead.

Quota impact: A call to this method has a quota cost of 50 units.

Common use cases

Request

HTTP request

POST https://www.googleapis.com/youtube/v3/commentThreads

Authorization

This request requires authorization with at least one of the following scopes (read more about authentication and authorization).

Parameters

The following table lists the parameters that this query supports. All of the parameters listed are query parameters.

Parameters
Required parameters
part string
The part parameter identifies the properties that the API response will include. Set the parameter value to snippet. The snippet part has a quota cost of 2 units.

The following list contains the part names that you can include in the parameter value:
  • id
  • replies
  • snippet

Request body

Provide a commentThread resource in the request body.

For that resource, you must specify a value for the following properties:

  • snippet.channelId
  • snippet.videoId
  • snippet.topLevelComment.snippet.textOriginal

Response

If successful, this method returns a commentThread resource in the response body.

Errors

The following table identifies error messages that the API could return in response to a call to this method. For more details, see the error message documentation.

Try it!

Use the APIs Explorer to call this API and see the API request and response.