Create comment

POST

https://api.notion.com/v1/comments

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.notion.com/v1/comments' \
--header 'Notion-Version;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "parent": {
        "page_id": "string"
    },
    "rich_text": [
        {
            "text": {
                "content": "string"
            }
        }
    ]
}'

Response Example

200 - Success

{
    "object": "comment",
    "id": "b52b8ed6-e029-4707-a671-832549c09de3",
    "parent": {
        "type": "page_id",
        "page_id": "5c6a2821-6bb1-4a7e-b6e1-c50111515c3d"
    },
    "discussion_id": "f1407351-36f5-4c49-a13c-49f8ba11776d",
    "created_time": "2022-07-15T20:53:00.000Z",
    "last_edited_time": "2022-07-15T20:53:00.000Z",
    "created_by": {
        "object": "user",
        "id": "067dee40-6ebd-496f-b446-093c715fb5ec"
    },
    "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
        }
    ]
}

Request

Header Params

Notion-Version

string

required

Body Params application/json

parent

object

required

page_id

string

required

rich_text

array [object {1}]

required

text

object

optional

Examples

Responses

🟢200OK

application/json

Body

object {0}

🟠403Forbidden

Modified at 2023-04-28 08:49:28

Retrieve a user

Retrieve comments