Docs: Tool reference
core toolset

create_post

Create a post. Creates a feedback post on a board, with the workspace's default status. Call find_similar_posts first and prefer voting on a match. Body is Markdown. End users post as themselves on public boards with posting on; members may post anywhere, and with on_behalf_of record a customer's request (creating the customer if needed; blocked customers are refused). Pass idempotency_key so a retry doesn't post twice. Customers who follow the board or category are emailed once the post is approved (never for private boards); team members who follow the board are notified. A post held for review emails its author when the team approves it.

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

Input

FieldTypeDescription
boardrequiredstringBoard slug, name or ID.
categorystringA category on that board.
titlerequiredstring
bodystringMarkdown. Raw HTML is shown as text, not rendered. Default: "".
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.
attachment_idsarray of stringUploads from create_upload whose files you've PUT, in display order (at most 10).
fieldsobjectCustom field values by key (list_custom_fields). Customers can set only the fields on the board's form; null clears a value.
idempotency_keystringRetry-safe key. Repeating a call with the same key returns the first result.

Output

FieldTypeDescription
idrequiredstringID with prefix "pst_"
workspace_idrequiredstringID with prefix "ws_"
slugrequiredstring
titlerequiredstring
boardrequiredobject
categoryrequiredobject or null
statusrequiredobject
authorrequiredobject
moderation_staterequiredone of: approved, pending, rejected, spamOnly approved posts are shown to end users other than the author.
ownerrequiredobject or nullThe responsible team member; null when unassigned, and always for end users.
etarequiredobject or null
tagsrequiredarray of object or nullInternal tags; null for end users, who never see tags.
merged_intorequiredobject or nullSet when merged into another post: this one is read-only and redirects there.
vote_countrequiredinteger
comment_countrequiredintegerPublic comments and replies.
voted_by_yourequiredboolean or nullWhether you have voted on it; null unless you're an end user.
shipped_inrequiredobject or nullThe published changelog entry that announced it, if any.
followed_by_yourequiredboolean or nullWhether you follow it (follow / unfollow); null for API keys and visitors.
emailable_followersrequiredinteger or nullHow many customers a status change with notify emails: followers who can be emailed and keep post updates on. Team only (null for customers and visitors).
status_changed_atrequiredstring (date-time)
last_activity_atrequiredstring (date-time)
versionrequiredinteger
created_atrequiredstring (date-time)
updated_atrequiredstring (date-time)
portal_urlrequiredstring (uri)
admin_urlrequiredstring (uri) or nullAdmin inbox link; null for end users.
bodyrequiredstringMarkdown, as written.
attachmentsrequiredarray of objectIn the order they were attached.
created_by_member_idrequiredstring or nullThe member who posted on the author's behalf; null otherwise or for end users.
fieldsrequiredobjectCustom field values by key; customers see public fields only.
roadmapsrequiredarray of object or nullInternal roadmaps it's on (team only; null for customers).
mrr_at_stakerequirednumber or nullSummed MRR of the distinct companies of its voters (team only).

Calling it

// MCP: tools/call
{ "name": "create_post", "arguments": {"board":"<string>","title":"<string>"} }

// Typed client
await carechannel.create_post({"board":"<string>","title":"<string>"});