Start building with the Notion API (original) (raw)

Comment

The Comment object represents a comment on a Notion page or block. Comments can be viewed or created by an integration that has access to the page/block and the correct capabilities. Please see the Capabilities guide for more information on setting up your integration's capabilities.

When retrieving comments, one or more Comment objects will be returned in the form of an array, sorted in ascending chronological order. When adding a comment to a page or discussion, the Comment object just added will always be returned.

{
    "object": "comment",
    "id": "7a793800-3e55-4d5e-8009-2261de026179",
    "parent": {
        "type": "page_id",
        "page_id": "5c6a2821-6bb1-4a7e-b6e1-c50111515c3d"
    },
    "discussion_id": "f4be6752-a539-4da2-a8a9-c3953e13bc0b",
    "created_time": "2022-07-15T21:17:00.000Z",
    "last_edited_time": "2022-07-15T21:17:00.000Z",
    "created_by": {
        "object": "user",
        "id": "e450a39e-9051-4d36-bc4e-8581611fc592"
    },
    "rich_text": [
        {
            "type": "text",
            "text": {
                "content": "Hello world",
                "link": null
            },
            "annotations": {
                "bold": false,
                "italic": false,
                "strikethrough": false,
                "underline": false,
                "code": false,
                "color": "default"
            },
            "plain_text": "Hello world",
            "href": null
        }
    ]
}

📘

Reminder: Turn on integration comment capabilities

Integrations must have read comments or insert comments capabilities in order to interact with the Comment object through the API.
For more information on integration capabilities, see the capabilities guide.

Property Type Description Example value
object string Always "comment" "comment"
id string (UUIDv4) Unique identifier of the comment. "ce18f8c6-ef2a-427f-b416-43531fc7c117"
parent object Information about the comment's parent. See Parent object. Note that comments may only be parented by pages or blocks. { "type": "block_id", "block_id": "5d4ca33c-d6b7-4675-93d9-84b70af45d1c" }
discussion_id string (UUIDv4) Unique identifier of the discussion thread that the comment is associated with. See the guide for more information about discussion threads. "ce18f8c6-ef2a-427f-b416-43531fc7c117"
created_time string (ISO 8601 date and time) Date and time when this comment was created. Formatted as an ISO 8601 date time string. "2022-07-15T21:46:00.000Z"
last_edited_time string (ISO 8601 date and time) Date and time when this comment was updated. Formatted as an ISO 8601 date time string. "2022-07-15T21:46:00.000Z"
created_by Partial User User who created the comment. { "object": "user", "id": "e450a39e-9051-4d36-bc4e-8581611fc592" }
rich_text Rich text object Content of the comment, which supports rich text formatting, links, and mentions. [ { "text": { "content": "Kale", "link": { "type": "url", "url": "https://www.healthline.com/nutrition/10-proven-benefits-of-kale" } } } ]