Notion integration
Amendary reads the Notion pages you watch. It writes approved fixes to those pages and adds dated entries to a product-updates page. Here is what to check before you connect.
Get it on the Notion Marketplace- Connect
- Sign in with Notion and pick the pages it may see.
- A fix lands as
- A direct edit to the page, or a comment.
- Languages
- One page at a time. Fixes are not carried into translated pages.
- Generate docs
- New pages under a parent page you pick.
What it reads
Notion asks which pages Amendary may see. Amendary lists their titles through Notion search. Search can miss a page, so you can also add one by pasting its link.
A listed page does nothing until you watch it. Engineering docs are mapped to the repo they describe. Help center pages follow what is set on the connection’s card, under Help articles follow: a GitHub repo, or each new entry on your public changelog.
Amendary reads a whole watched page once to list what it claims, then only the matching sections when a change is checked. Comments are never read.
What it changes
Text blocks on the pages you watch. Bold, links, inline code and mentions on unchanged text stay as they were.
When a fix cannot be placed on a block, Amendary leaves a page comment instead of guessing. A product-updates page is never corrected. It only gains new dated entries.
Notion has no suggested-edit mode for integrations, so an applied fix is a direct edit. It is logged in Amendary and can be undone.
Permissions
The integration asks for these four capabilities, and nothing else:
- Read content, to list page titles and read the pages you watch.
- Update content, to fix text on the pages you watch.
- Insert content, to add product-update entries and create pages when you generate docs.
- Insert comments, to leave a comment when a fix cannot be placed on a block.
It does not ask to read comments. The access token is stored encrypted.
How a fix lands
- Once a day, Amendary checks what shipped against the pages you watch. Engineering docs are checked per landed commit.
- It drafts the smallest fix for the passage, with the change as evidence.
- New teams start on Review first: every fix waits for you. On Apply automatically (paid plan or your own key), a fix still waits when it states a value the change does not back up, removes content, or adds new text.
- Notion pages are checked one by one. A fix is not carried into translated pages, and missing languages are not drafted.
Undo and disconnect
Undo is in the Queue for 30 days. It writes the stored original back, but only if nobody edited the block since. The original lives in Amendary, so undo works on every Notion plan.
A workspace owner can disconnect on the Pages tab. Amendary deletes the connection with its pages, fixes, check results and product-update entries. Reconnecting does not bring them back. Nothing in Notion changes. To remove access in Notion too, remove the integration in Notion’s settings.
Generate and cleanup
Generate docs creates pages under a parent you pick, and can start a product-updates changelog. If docs are already there, it follows their layout.
Cleanup checks the pages you pick, watched or not, against your code and says which to keep, fix or retire, with the proof. It never edits a page.
Diagrams suggests a diagram for a page. It is added as an image only after you approve it.
All three spend credits, shown before the run.
Next steps
- Keep your Notion help center current: the problem, outcome and an example
- Update Notion pages after a release: follow the workflow after connecting
- Connect Notion: set up step by step
- Pages and mapping: listed versus watched pages
- Document types: including the product-updates page
- Security: what is stored, sent and deleted
- Our own Help Center: kept in Notion by Amendary
- Our product-updates changelog: written from what shipped
Try Amendary with Notion
Connect Notion, choose the pages or articles to watch, and review proposed corrections with the change behind each one.
Free for 14 days with no card, and every edit waits for your review. Or free forever with your own Anthropic API key. Code is never touched.