leave a useful notion comment where it belongs
put the review question where the document owner will actually see it. the bot can leave a notion page comment or reply in an existing discussion.
it cannot start a new inline thread on a block. draft the wording in dusk chat, choose the page or thread, and keep sending on Ask every time so posting waits for you.

create comment, in plain words
choose the destination before polishing the words. a page comment suits feedback about the whole document. for a reply, point the bot at the existing discussion. it finds the right thread.
“comment on this sentence” needs a clearer destination. this action cannot start a new inline discussion on that sentence.
ask to see the page or thread alongside the proposed text. a good comment in the wrong place still wastes someone’s time.
a routine to copy
paste this into a chat with your bot
every other tuesday at 16:20, read new proposal pages in the silvermere instruments proposals database in notion. compare delivery dates with the matching project briefs in notion. for each clear conflict, prepare one page-level comment asking which date is current. read existing comments first and skip questions already raised. show each page, the two dates and the proposed wording here. post only the comments i allow. report where each comment appears. never invent a deadline or start a new inline thread.- when
- alternate tuesdays at 16:20
- needs
- notion read and write, including reading pages and comments; sending set to ask every time
what comes back looks like this (an example)
comment awaiting approval
page: silvermere instruments proposal
text: the proposal says friday delivery; the project brief says the following monday. which date should we use?
no comment posted yet.good jobs for it
- settle a disputed date. ask the document owner which delivery date is current.
- keep the decision together. reply in the existing design-review discussion.
- question a forecast. leave a page comment asking for the missing source.
before it runs
dusk bot counts Create comment as a send: it reaches people or moves money, so it waits for your Allow (unless you set a daily amount, or the bot is on Full access with no sending rule, which lets it send up to 25 a day). a bot you allow only to read can never call it.
the permissions Notion asks for to run it: comment:write.
how to start
- connect the review bot. give it notion read and write so it can read and comment.
- choose the destination. open the page or existing thread alongside the proposed words.
- keep posts supervised. set sending on your behalf to Ask every time. a daily allowance skips individual approvals.
- read it in notion. allow the post, then follow its link to the discussion.
limits worth knowing
- careful with Full access: a bot there with no sending rule can send up to 25 a day without asking. give it Ask every time.
- use a page comment for a new question. this action can reply in an existing inline thread but cannot start one.
- read the conversation first. nobody needs another reminder of a question they answered yesterday.
the details it works from
| input | required | what it is |
|---|---|---|
comment | yes | Content of the comment as a NotionRichText object or a JSON string. |
discussion_id | no | The ID of an existing discussion thread to which the comment will be added. |
parent_page_id | no | The ID of the Notion page where the comment will be added. |
from composio's catalog for Notion (action NOTION_CREATE_COMMENT, read 12 november 20264). your bot fills these in from what you tell it.
try it in 2 minutes
- paste a notion page link
- ask for a short page-level comment
- read the destination and wording
- allow the post with sending set to ask every time
mistakes people make
asking for an inline comment on a new sentence
use a page comment, or point to an existing discussion for a reply.
posting a question somebody already answered
read the existing discussion before writing the next comment.
questions
can it reply to a notion comment that is already there?
yes. point it at the comment and ask it to read the surrounding discussion before replying.
can i keep the feedback private until i approve?
prepare it in dusk chat first. set sending to ask every time. posting is the step that puts the note in notion.
sources
drafted with ai help from the dusk bot docs and the sources listed on this page, then checked against them. if something here is wrong or out of date, write to [email protected].
turn a clear request into a notion database row
a notion bot that keeps the next step easy to find
add a batch of notes to an existing notion page
give new notion notes a proper home
put a notion page under its new parent
ask for the notion records that match your conditions