Notion API - Public Beta (English)
  1. Comments
Notion API - Public Beta (English)
  • Introduction
  • Integration capabilities
  • Request limits
  • Status codes
  • ENDPOINTS
    • Authentication
      • Authentication
      • Token
    • Blocks
      • Delete a block
      • Append block children
      • Retrieve a block
      • Update a block
      • Retrieve block children
    • Databases
      • Filter database entries
      • Sort database entries
      • Update database properties
      • Retrieve a database
      • Update a database
      • Query a database
    • Pages
      • Archive a page
      • Retrieve a page property item
      • Create a page
      • Retrieve a Page
      • Update Page properties
    • Users
      • List all users
      • Retrieve your token's bot user
      • Retrieve a user
    • Comments
      • Create comment
        POST
      • Retrieve comments
        GET
    • Search
      • Search optimizations and limitations
      • Search by title
  • OBJECTS
    • Block
    • Comment
    • Unfurl attribute object for Link Previews
    • Page
      • Page
      • Page properties
    • Database
      • Database
      • Database properties
    • User
      • User
      • Comment
    • Other
      • Emoji object
      • File object
      • Parent object
      • Rich text object
  • Versioning
    • Versioning
    • Changes by version
  • ENDPOINTS Copy
    • Authentication
      • Authentication
      • Token
    • Blocks
      • Retrieve a block
      • Update a block
      • Retrieve block children
      • Delete a block
      • Append block children
    • Databases
      • Filter database entries
      • Sort database entries
      • Update database properties
      • Retrieve a database
      • Update a database
      • Query a database
      • Create a database
    • Pages
      • Archive a page
      • Retrieve a Page
      • Update Page properties
      • Retrieve a page property item
      • Create a page
    • Users
      • Retrieve a user
      • List all users
      • Retrieve your token's bot user
    • Comments
      • Create comment
      • Retrieve comments
  1. Comments

Create comment

POST
https://api.notion.com/v1/comments
Request 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 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
Previous
Retrieve a user
Next
Retrieve comments
Built with