create_post
Creates a new post with status open. Body accepts plain text; rich formatting (links, lists, images) only via the dashboard editor. Pass contact_id to attribute the post to a known contact — useful for filing feedback on behalf of a specific customer.
required scope: read:write.
example prompts
Section titled “example prompts”- “post a bug report titled ‘slow exports’ to the alpha board with this stack trace as the body.”
- “for each summarised customer complaint, create a feedback post on the public board.”
- “attribute this complaint to ctc_01H8… so it shows up on their profile.”
| field | type | required | notes |
|---|---|---|---|
board_id | string | yes | Target board id from list_boards. |
title | string (max 200 chars) | yes | |
body | string (max 50,000 chars) | no | Plain-text body. Rendered as a single paragraph in the dashboard. |
tag_ids | string[] (max 3) | no | |
contact_id | string | no | Contact id to attribute this post to (from list_contacts / identify_contact). |
tag_idsmust be unique; duplicates are rejected MCP-side, not at the database.contact_idmust reference a contact in the same workspace; foreign or unknown ids returnERR_NOT_FOUND.
output
Section titled “output”The created post object.