Any data. Any tool. Any agent. All in Notion.
- Tweets 590
- Following 23
- Followers 26,594
- Likes 1,366
Pinned Tweet
Introducing: the Notion Developer Platform
New building blocks that help you (and your coding agents) sync any data source, build any tool, and orchestrate any agent.
Follow along 👇 nitter.app/i/broadcasts/1AJEmOArr…
31
104
643
526,843
We’ve open-sourced our MCP (Model Context Protocol) — now available on GitHub.
Plug it into your favorite client and start building richer AI integrations with Notion in minutes ✨
github.com/makenotion/notion…
31
354
2,772
470,759
🏗️ The wait is over! Notion's API is now in public beta.
→ Retrieve, query & list databases
→ Create & retrieve pages, and update properties
→ Search pages & databases
→ Retrieve & append block children
Get started at developers.notion.com. developers.notion.com
46
379
2,049
Agents are getting more powerful.
But without a way to use your tools, they can’t actually get much done.
That’s why we’ve launched Notion’s hosted MCP server — so AI agents like @cursor_ai + @claudeai can work directly in your workspace. Here’s the inside story…
41
79
1,370
270,991
We're on track for the public beta this Spring 🌿
Curious about how it's coming along?
🆕 Integrations can read and write page content
🆕 Access to pages outside of databases
Next up:
🔜 OAuth for access to multiple workspaces
🔜 Users can share pages during authorization
18
62
517
Quick progress report!
Functionality enabled by the API so far:
✔️ Query, filter & sort content in DBs
✔️ Workflow automation
✔️ Sync DBs with other tools
What we're building right now:
🔜 Webhooks
🔜 Unblock OAuth use case
Sign up here for more: notion.so/api-beta
26
41
466
Just shipped: file uploads via API.
Images, videos, PDFs, whatever you need, now supported. A few things you can do:
- Auto-assign emojis + cover images
- Migrate files from Google Drive, etc.
- Upload contracts or log feedback w/ screenshots
12
47
443
107,715
New: Notion MCP — a hosted server for AI agents to securely read + write in your workspace.
Works out of the box with @ChatGPTapp, @claudeai, and @cursor_ai. So your AI tools can reference, create, and update — like real teammates.
20
44
421
111,877
We just launched our new comments API! This allows you to:
→ Read comments from a page or block
→ Add a comment to a page
→ Add a comment to an existing thread
💬 Learn more: ntn.so/commentsAPI
ALT This web browser shows the “Create comment” guide on the Notion developer portal. The left side of the guide has text-based instructions on how to create comments using the new comments API. The right side displays a Javascript code example. The code is colored purple, blue, red and green and set against a rectangular black box.
17
31
314
🌱 We are still on track to launch the public beta this spring!
Here's what we've been up to lately:
✔️ Improved error handling
✔️ Including created_time and last_updated_time in page responses
🔜 Third party auth
🔜 Read & write page contents (anything beneath DB properties)
10
23
292
🚨 New API endpoints! Now you can:
→ Create a database and update its properties
→ Update a block's content without having to delete and create a new one
→ Retrieve a block
There's also a new version with non-backwards-compatible changes — learn more: developers.notion.com/change…
2
31
245
💥 Last week, we brought Notion’s API out of beta, accompanied by:
→ Support for additional block types
→ Better admin controls and permissions
→ A brand new integration gallery
Start building now! developers.notion.com
10
24
195
🥁 Just shipped some top feature requests for the API!
→ Update and retrieve page icons & cover images
→ Add and retrieve externally hosted images & files
→ List and append NEW block types: embed, image, video, file, PDF & bookmarks
Learn more: developers.notion.com/change…
10
21
187
We’ve shipped a new API version: 2025-09-03.
It unlocks support for multiple data sources in databases — so your integrations can keep up with what’s possible in Notion.
Upgrade your API version for better database support: ntn.so/api-upgrade-guide
Databases just got more powerful ✨ You can now parent multiple data sources in a single database — and add linked views too.
One place. Many sources. A true hub for your workflow.
Rolling out this week.
10
21
195
37,573
🛠 We now support creating, reading and updating simple tables through the API!
See our changelog for more details: developers.notion.com/change…
3
24
168
🚢 Lots of API improvements have shipped!
✔️ You can create new databases with the API
✔️ Page objects now return the web address of the page in the url key
✔️ Database objects now return the parent
For more, take a look at our changelog: developers.notion.com/change…
4
20
178
🚢 Just added some new API functionality:
→ New endpoint to delete block objects, which moves any block type (including pages) to the trash
→ Added support for creating formula, relation, and rollup property types when creating or updating a database
14
17
157
Now live: @MistralAI's Le Chat can talk to @NotionHQ. Reference pages, create new ones, and update existing docs — all without leaving Le Chat.
Introducing 20+ connectors powered by MCP and a fully controllable Memory in Le Chat—making it one of the most connected and relevant AI assistants for enterprises and consumers.
Why switch to Le Chat? A 🧵
6
9
157
31,059
Exciting news! @NotionAPI is a launch partner for Postman Flows, a new low-code product.
Check out our API Collection here to get started: ntn.so/flows
The next generation of software development is here—Postman Flows 🎉. With Postman Flows, anyone can connect APIs to build workflows, integrations, and more in a visual and collaborative environment. #BuiltWithPostman
@shamasis shares all the details: blog.postman.com/postman-flo…
6
33
151
62,867
🔗 We have a new Link Preview API!
This allows users to preview authenticated content in Notion when they paste a link from your product.
Read more: developers.notion.com/page/l…
ALT There is an illustration of the Notion logo surrounded by 10 abstract black-and-white shapes set on a cream background. Next to the illustration is text reading: "New Link Preview API."
5
16
146
🌟 In case you missed it: we released additional API support for key block types! Now you can:
→ create and reference synced blocks across Notion pages
→ add columns to pages and other blocks
→ update embeds and bookmarks
Learn more: developers.notion.com/change…
3
19
127
⚙️ New API functionality!
You can now dynamically add new option values for select and multi-select properties via the Create and Update Page endpoints, when these options didn't exist in the database already.
More here: developers.notion.com/change…
7
16
138
We’re honored to be nominated for Golden Kitty awards alongside some amazing products and dev tools 😻 Thanks @producthunt!
7
9
123
Our Notion API collection is officially verified on @getpostman!
With this, you can trust that you’re getting the most reliable + up-to-date tools to create integrations 👷🏾♀️
Let’s build: postman.com/notionhq
5
19
122
26,118
Just shipped a few improvements to our OAuth flow!
✔️ Pick specific pages to grant access to in the new search field, not just top-level pages
✔️ The page picker now remembers which pages have already been shared with the integration
Learn more: developers.notion.com/change…
4
8
109
📺 We re-recorded the demo from yesterday’s live coding workshop, and the new video is now ready to view!
Watch us build a sample integration with Notion and answer your top questions about the API:
crowdcast.io/e/build-on-the-…
4
8
71
🛳️ We just shipped new granular permissions for integrations built on Notion’s API!
In the integration set-up flow, developers can now request specific permissions from users, based on their integration’s needs.
3
3
65
Today’s hosted MCP server is an all-in-one remote solution:
• One-click OAuth setup, no keys or local installs.
• Hosted by us → we can ship updates instantly.
• Tools designed for agents, not humans parsing API responses.
2
6
53
7,593
We’re hiring our first Platform PM! Come help drive the development of powerful platform experiences at Notion ⚒️
🔔We're hiring our first Product Managers at @NotionHQ!
If you're interested in exploring our Platform or Growth PM roles and helping build the product function from the ground up, keep reading! 👇
⚒️ Platform PM: grnh.se/a4a7b24d3us
📈 Growth PM: grnh.se/d08e4c773us
8
51
MCP (Model Context Protocol) is a universal language for agents to discover & use tools.
Instead of digging through API docs or writing glue code, the agent just knows how to do things — create a page, run a search, update a task — because the tool tells it what’s possible.
Think: REST APIs → for AI.
1
5
48
10,363
This isn’t just the API in a new wrapper. We rewrote key operations from the ground up:
• create-page and update-page are agent-optimized, not rigid web API calls.
• Responses use Notion-flavored Markdown for rich content per token (cheaper, faster).
• Semantic search works across Notion + 10+ connected apps.
2
5
50
7,815
Back now enables you to automate replies to your team's questions in Slack, MS Teams, or Google Chat, pulling from FAQs and policies in Notion — all powered by the Notion API 👷
We’re live on Product Hunt with an exciting new partnership 🎉 Bring policies and how-tos from a Notion wiki into your employees’ flow of work. Check us out and let us know what you think 😎
buff.ly/3hLETPO
4
48
We’ve made a small tweak to our last API version 2022-06-28. We now return all page property values as we did in previous versions, read more here:
developers.notion.com/change…
5
5
43
Join us this Wednesday for a live streamed workshop! Code along with us, or watch as we build an integration together 🔨
Sign up here: lu.ma/fhbprf92
1
3
47
Read the full post from @KennethSinder for all the details → ntn.so/hostedmcp
7
6
44
6,272
We recently updated our Postman collection to reflect the most recent changes to our API! Go tinker 🔧
postman.com/notionhq
1
4
42
🧰 LIVE coding workshop starting in just a few hours!
Stream it here, or watch the recording later at the same link: crowdcast.io/e/build-on-the-…
4
43
Earlier this year we shipped an open-source MCP server for Notion. It worked… but only if you:
• Knew Docker
• Copied API keys manually
• Enjoyed reading JSON for fun
Early adopters saw the potential, but the barrier was too high. We learned quickly.
1
4
41
9,241
Two insights from that first version:
• Setup was too hard → most people never made it past step 1.
• 1:1 API mapping made for clunky agent experiences (too many calls, too much token waste).
So we went back to the drawing board.
2
4
40
20,690
Why this is interesting?
When every tool has a hosted MCP server, AI agents can instantly connect, understand what’s possible, and act.
This is just our first step — we’re working with partners like Cursor to push the protocol forward, from discovery standards to marketplaces of trusted MCP servers.
1
4
34
6,687
What you can do now, without touching a UI:
Turn a requirements doc into a prototype in Cursor, update project statuses + ping stakeholders, or search your entire knowledge base by asking questions.
All through natural language.
1
5
32
5,389
🔑 We’ve made an update to our Public API token format!
This change enhances our compatibility with secrets scanners, making it easier to distinguish Notion API tokens from other API tokens.
Read more: developers.notion.com/page/c…
1
4
27
7,489
📅 After July 1st, integrations with the Notion API created before June 1, 2021 will require a "Notion-Version" header. For more details, take a look at our changelog developers.notion.com/change…
1
8
26
Join us for a livestream with @getpostman this Thursday from 11AM - 12:30PM PST!
We'll be live coding an integration between @NotionHQ & @typeform 🤓 linkedin.com/events/68091630…
1
6
24
Notion’s first summit, Block x Block: Europe, is bringing our community together to connect, learn, and get inspired.
We’ll be sharing more about our platform and hosting a breakout session on building with the Notion API.
📅 Join us on June 29th hopin.com/events/block-x-blo…
3
20
Excited to announce the launch of Notion's Content Transfer API for Enterprise plan workspaces!
Workspace owners can now programmatically transfer private pages of former members to an active member after removal. 🙌 notion.com/help/transfer-con… #NotionAPI
1
12
2,492
Ready to install your first integration? Try these:
@automate → automate.io/integration/noti…
@IFTTT → ifttt.com/notion_so
@typeform → typeform.com/connect/notion
notion.so/help/add-and-manag…
2
15
Learn more about building with the Notion API from @amngpta's workshop. This integration with @Spotify is a great way to get familiar with working with databases, pages and tags. 🎵 piped.video/watch?v=jiVDZZUS…
1
16
Our API documentation host ReadMe is currently experiencing an outage. Follow readmestatus.com for updates. You may not be able to access documentation at developers.notion.com until this is resolved.
3
1
12
Curious what this looks like?
Check out link previews created by the teams at @Pitch, @Amplitude_HQ, @_hex_tech and @GRID_hq: notion.so/releases/2022-05-1…
2
14
Notion users may experience general performance slowness. Engineering is currently investigating and implementing mediations.
1
1
13
8,190
See all the products (and vote for your faves) here: producthunt.com/golden-kitty…
1
12
For teams with an Enterprise subscription, there's a new setting in the Security & identity section to "Prevent members from installing new third party integrations."
ALT This is an image of the Security & identity menu in Notion. At the bottom of the menu, there is an option called "Prevent members from installing new third party integrations," with a blue toggle at the right. There is a large red arrow pointing to this toggle setting.
1
12
We had an issue where users experienced errors when creating a token with the Notion API Oauth token endpoint starting from Sep 27th, 2:11 PM PDT.
This issue has been resolved now. Users should no longer be encountering any errors.
1
10
1,986
We're seeing increased latency and some degraded performance with the public API. We've partially identified the issue, and are still investigating.
2
10
3,542
Some pages and databases are not appearing in API search for some integrations, as well.
Some pages and databases are not appearing in search results for some users. This affects functions including quick find, move to, page mentions, inline links, and web clipper. We have identified the cause and are working on a resolution.
1
1
10
🎉 New in Notion SCIM API! You can now assign user roles (workspace owner, membership admin, or member) using the role attribute of the Users endpoint. Streamline user management with ease. Learn more: notion.com/help/provision-us… #NotionAPI
2
9
1,806
To manage and remove the integrations added by members in your workspace, admins can go to Settings & Members → Integrations.
1
9
The Notion App and API are experiencing some degraded performance. We are currently investigating.
2
2
8
3,052
For more details, see our changelog: developers.notion.com/change…
7
We aim to support all block types in the API, but are knocking them down one by one! Thanks for your feedback 🙏
1
7
Notion developer website (developers.notion.com) is down due to the 3rd party service's outage. This is an issue with the API portal page and does not affect the API functionality itself. We are monitoring the situation and awaiting an update from the 3rd party.
1
7
2,497
Engineering has implemented mediations which should have resolved performance issue. We’ll continue to monitor performance and provide updates if we run into issues again.
1
1
6
4,164
The ReadMe outage has been resolved. You should be able to access developers.notion.com without issue.
6
We have resolved the underlying cause and are monitoring. Previously-affected pages will become available in search results again over the next few days.
3
Thanks for the feedback. We know this is highly requested and it's on our list for improvements to the API!
1
4
@IFTTT has a Siri + Notion integration worth exploring! ifttt.com/notion_so
1
4
We've confirmed the source of the issue and are continuing to work on a fix. We currently expect the issue to be resolved for all search functions, including API search, within the next day.
1
4
Yes, we recommend taking a look at a couple of workshops we've put together on how to build an integration with the API:
- crowdcast.io/e/build-on-the-…
- piped.video/watch?v=jiVDZZUS…
1
3
We don't yet have the ability to delete pages in the API, but you can archive them (simply set the archived property).
2
3
We are currently experiencing degraded performance with the Notion API where Error rates are elevated. We are investigating the issue.
1
2
2,387
We added image support pretty recently!
🥁 Just shipped some top feature requests for the API!
→ Update and retrieve page icons & cover images
→ Add and retrieve externally hosted images & files
→ List and append NEW block types: embed, image, video, file, PDF & bookmarks
Learn more: developers.notion.com/change…
2
There is not a way to do this at the moment, but definitely something we're looking into for the future.
2