Docs: Tool reference
core toolset

create_comment

Comment on a post. Adds a Markdown comment to a post, or a reply with reply_to (replies to a reply join its thread). visibility internal keeps it to the team; replies to internal comments must be internal. Team members can @mention colleagues via mentions, and with on_behalf_of post a customer's comment. Pass idempotency_key. A team member's public comment emails the post's customer followers (per their email settings); any comment notifies team members who own, wrote, commented on or follow the post, and mentioned members. Commenting customers follow the post.

Toolset
core
Who can call it
OwnersManagersContributorsCustomersAPI keys
REST
POST /api/v1/w/{workspace}/posts/{post}/comments
Behavior
changes dataaccepts idempotency_key

Input

FieldTypeDescription
postrequiredstringThe post's ID (pst_…) or slug (the last part of its portal URL).
bodyrequiredstringMarkdown. Raw HTML is shown as text, not rendered.
visibilityone of: public, internalDefault public, or the thread's visibility for replies. internal is team only.
reply_tostringID with prefix "cmt_"
mentionsarray of stringTeam members to @mention, by member ID or email. Team only.
on_behalf_ofobjectTeam and service accounts only: the end user this post is from. Found by user_id, external_id or email, and created if missing.
idempotency_keystringRetry-safe key. Repeating a call with the same key returns the first result.

Output

FieldTypeDescription
idrequiredstringID with prefix "cmt_"
post_idrequiredstringID with prefix "pst_"
parent_idrequiredstring or nullThe comment this replies to; null at the top level.
authorrequiredobject
bodyrequiredstring or nullMarkdown; null once the comment is deleted.
visibilityrequiredone of: public, internalpublic: everyone who can see the post. internal: team members only.
mentionsrequiredarray of object
deletedrequiredbooleanShown only to keep a deleted comment's replies in place.
edited_atrequiredstring (date-time) or null
versionrequiredinteger
created_atrequiredstring (date-time)
updated_atrequiredstring (date-time)

Calling it

// MCP: tools/call
{ "name": "create_comment", "arguments": {"post":"<string>","body":"<string>"} }

// Typed client
await carechannel.create_comment({"post":"<string>","body":"<string>"});