Actions35
- Space Actions
- Page Actions
- Template Actions
- Search Actions
- Comment Actions
- Get Page Footer Comments
- Get Page Inline Comments
- Get Blog Post Footer Comments
- Get Blog Post Inline Comments
- Get Custom Content Comments
- Get Footer Comments
- Create Footer Comment
- Get Footer Comment By Id
- Update Footer Comment
- Delete Footer Comment
- Get Footer Comment Children
- Get Inline Comments
- Create Inline Comment
- Get Inline Comment By Id
- Update Inline Comment
- Delete Inline Comment
- Get Inline Comment Children
Overview
The "Create Inline Comment" operation in the Confluence Cloud node allows users to create inline comments on Confluence pages or blog posts. Inline comments are tied to specific text selections within the content, enabling contextual discussions and feedback directly related to particular parts of a document. This operation supports creating top-level inline comments (by specifying a page or blog post ID) or replies to existing comments (by specifying a parent comment ID). It is useful for collaborative editing, peer reviews, or any scenario where precise commentary on document content is needed.
Practical examples:
- Adding an inline comment to highlight a typo or suggest rephrasing in a Confluence page.
- Replying to an existing inline comment to continue a discussion thread on a specific paragraph.
- Creating inline comments on blog posts to gather feedback from readers.
Properties
Name | Meaning |
---|---|
Request Body | The JSON-formatted request body data containing details of the inline comment to create. This includes fields such as pageId or blogPostId for top-level comments, parentCommentId for replies, and inlineCommentProperties to specify the text selection that the comment relates to. |
Output
The output of this operation is the JSON response from the Confluence Cloud API representing the created inline comment. This typically includes:
- The unique ID of the new inline comment.
- Metadata about the comment such as author, creation date, and status.
- The content of the comment.
- Information linking the comment to the specific text selection (
inlineCommentProperties
). - Any reply relationships if it is a child comment.
No binary data is involved in this operation.
Dependencies
- Requires access to the Confluence Cloud REST API.
- Requires an API authentication token credential configured in n8n to authorize requests.
- The base URL for API requests is derived from the user's Confluence domain credential.
- Proper permissions in Confluence are required to view the content and create comments in the target space.
Troubleshooting
- Permission errors: If the user lacks permission to view the page/blog post or to create comments, the API will return authorization errors. Ensure the API token has sufficient rights.
- Invalid request body: Malformed JSON or missing required fields in the request body can cause validation errors. Verify the JSON structure and required properties like
pageId
orparentCommentId
. - Resource not found: Specifying invalid or non-existent page, blog post, or comment IDs will result in not found errors.
- API rate limits: Excessive requests may be throttled by Confluence; handle rate limit responses gracefully.