dusk bot
integrationscreate comment

dusk botintegrationsnotion

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.

by the dusk bot team · checked · how we made this

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.

pixel art: a yellow pixel bot and an indigo pixel bot beside the Notion mark on a white tile, a notebook and two chat bubbles, on a grassy meadow in front of a birch wood under purple hills, one saying "leave this review note"

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

  1. connect the review bot. give it notion read and write so it can read and comment.
  2. choose the destination. open the page or existing thread alongside the proposed words.
  3. keep posts supervised. set sending on your behalf to Ask every time. a daily allowance skips individual approvals.
  4. 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

inputrequiredwhat it is
commentyesContent of the comment as a NotionRichText object or a JSON string.
discussion_idnoThe ID of an existing discussion thread to which the comment will be added.
parent_page_idnoThe 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

  1. paste a notion page link
  2. ask for a short page-level comment
  3. read the destination and wording
  4. 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

  1. dusk bot docs: files and apps
  2. dusk bot docs: routines
  3. dusk bot docs: a bot's computer
  4. composio, Notion toolkit (catalog version 20261101_00), checked 12 november 2026

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].