Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.notion.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Request format (input)

​
Object properties

ParameterTypeDescriptionExample value
typestring (enum)Possible type values are:"connection", "user", or "custom""user"
customobjectIf the type is "custom", include a custom object specifying the custom name"custom": { "name": <Custom Name> }"custom": { "name": "Notion Bot" }
  • "connection": name of the connection
  • "user": name of the user who authenticated the connection (only for public connections)
  • "custom": any custom name
Example of a Create Comment request with custom display name: 
{
  "parent": {
    "page_id": "d0a1ffaf-a4d8-4acf-a1ed-abae6e110418"
  },
  "rich_text": [
    {
      "text": {
        "content": "Thanks for checking us out!"
      }
    }
  ],
  "display_name": {
    "type": "custom",
    "custom": {
      "name": "Notion Bot"
    }
  }
}

​
Response format (output)

​
Object properties

The response of Comment APIs like Create comment contains attachments with the following fields:
FieldTypeDescriptionExample value
typestring (enum)Possible type values are:"connection", "user", or "custom""custom"
resolved_namestringThe custom display name shown in a comment"Notion Bot"
{
  ...existing parameters omitted,
  "display_name": {
    "type": "custom",
    "resolved_name": "Notion Bot"
  }
}