Actions107
- Attachments Actions
- Auth Actions
- Collections Actions
- Comments Actions
- Data Attributes Actions
- Documents Actions
- Documents Info
- Documents Import
- Documents Export
- Documents List
- Documents Documents
- Documents Drafts
- Documents Viewed
- Documents Answer Question
- Documents Search Titles
- Documents Search
- Documents Create
- Documents Update
- Documents Templatize
- Documents Unpublish
- Documents Move
- Documents Archive
- Documents Restore
- Documents Delete
- Documents Users
- Documents Memberships
- Documents Add User
- Documents Remove User
- Documents Archived
- Documents Deleted
- Documents Duplicate
- Documents Add Group
- Documents Remove Group
- Documents Group Memberships
- Documents Empty Trash
- Events Actions
- File Operations Actions
- Groups Actions
- O Auth Clients Actions
- O Auth Authentications Actions
- Revisions Actions
- Shares Actions
- Stars Actions
- Users Actions
- Templates Actions
- Views Actions
Comments → Comments Create
AI-generatedSummary
Creates a new comment on a document in Outline.
Inputs
- documentId (required) — The ID of the document where the comment will be created.
- text — The content of the comment in markdown format.
- parentCommentId — The ID of the parent comment to reply to in a thread.
- data — JSON object containing raw document node body data for the comment.
- id — An optional custom ID to assign to the comment.
- requestOptions — Additional request options such as timeout, proxy, batching, or SSL settings.
Output shape
A single object containing the created comment details.
Returns the JSON body sent by the Outline API response.
Examples
Example 1: Create a root-level comment on a document
Set Document Id to 'doc-123' and Text to 'Great documentation!'
Example 2: Create a threaded reply to a parent comment
Set Document Id to 'doc-123', Parent Comment Id to 'comment-456', and Text to 'I agree with this point.'