Skip to content

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.

  • “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.”
fieldtyperequirednotes
board_idstringyesTarget board id from list_boards.
titlestring (max 200 chars)yes
bodystring (max 50,000 chars)noPlain-text body. Rendered as a single paragraph in the dashboard.
tag_idsstring[] (max 3)no
contact_idstringnoContact id to attribute this post to (from list_contacts / identify_contact).
  • tag_ids must be unique; duplicates are rejected MCP-side, not at the database.
  • contact_id must reference a contact in the same workspace; foreign or unknown ids return ERR_NOT_FOUND.

The created post object.