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.

​
User management

Yes, the SCIM API is available for workspaces in Notion’s Enterprise Plan. Learn more about using SCIM with Notion
Yes, single sign-on (SSO) can be configured for workspaces in Notion’s Enterprise Plan. Learn more about SSO with Notion.

​
Connections

Confirm that you are an admin in the workspace where the connection was created. You can check inside Notion via Settings & Members in the left sidebar. If you’re not an admin in any of your workspaces, you can create a personal workspace for free.

​
Databases

Double check to see that your connection has been shared with the database the relation property points to — This should fix it! If you’re still seeing unexpected results, reach out for help.
Double check to see that your connection has been shared with the database the relation property points to — This should fix it! If you’re still seeing unexpected results, reach out for help.
You have two options:
  1. Add a rollup property to the database which uses a formula to get the related page’s title. This works well if you have access to updating the database’s schema.
  2. Otherwise, retrieve the individual related pages using each page ID.
Yes, the API has rate limits. Your connection can gracefully handle these limits by slowing down when the API responds with a HTTP status 429.
All properties in pages are stored as rich text. Notion will convert that rich text based on the types defined in a database’s schema. So when a type is changed both in the Notion and in the API, the data will continue to be available, it is just presented differently.For example, a multi select property value is represented as a comma-separated list of strings (eg. “1, 2, 3”) and a people property value is represented as a comma-separated list of IDs. These are compatible and the type can be converted.Note that not all type changes work. In some cases data will no longer be returned, such as people type → file type.

​
API limitations

Use the file upload API to upload files such as images and PDFs to your workspace. Notion MCP does not currently support file uploads.
Not currently, but we’re open to your feedback on this. Get in touch and tell us a little more about your problem.
If you have a programming question, like in a specific programming language or framework, you can ask on StackOverflow. Use the tag notion-api so the rest of the community can help answer your question.
If you’re experiencing a bug or a disruption, contact our support team.