Actions

Call the createDraftPost MCP tool

Save a LinkedIn post YOU wrote as a Reachium draft (you author the copy; this only saves it). PERSONAL types (no keyword needed): authority_building, problem_awareness, personal_story. LEAD-MAGNET types (REQUIRE a Comment "KEYWORD" CTA in the body AND the matching lead_magnet_keyword param): trend_borrowing, audience_borrowing, step_by_step, case_study_format, company_update. Default to personal unless running a lead-magnet funnel. Never use em dashes in the copy (arrows are fine). LinkedIn caps bodies at 3000 characters. Pull getPlaybook("content") BEFORE drafting: draft-type trade-offs, length target, and CTA rules. The topic also carries the craft skills (post-ideation, post-copywriting, post-hooks, post-images): work idea -> body -> hook LAST -> visual, and pull the skill for the stage you are on. Returns post_id. Surface returned warnings to the user. schedulePost needs the launch scope - without it, the user schedules in the Content UI.

Called through the Actions bridge: the response is that tool's own result, wrapped as { data: <tool result> } under HTTP 200. Billing, daily-cap, and confirm-step outcomes are embedded INSIDE data, never remapped to an HTTP status (see the templated /api/v1/actions/{toolName} operation above for the full protocol, and x-mcp-actions for this tool's machine-readable scope/cap/confirm_behavior fields). Authentication, request-shape, and optional idempotency-protocol failures still use their documented non-200 statuses.

post/api/v1/actions/createDraftPost

Request

  • Base URL: https://app.reachium.io
  • URL: https://app.reachium.io/api/v1/actions/createDraftPost
  • Auth: HTTP bearer

Headers

Idempotency-Keystring

Optional caller-generated key (8-200 characters: letters, digits, dot, underscore, colon, or hyphen). A final tool result is replayed for the same key and body. An ambiguous result remains 409 under that key; reconcile external state before using a new key. Reuse with a different body returns 422.

Request body

topicstring required

One-line summary of what the post is about.

contentstring required

The full post body, ready to publish.

draft_type'authority_building' | 'problem_awareness' | 'personal_story' | 'trend_borrowing' | 'audience_borrowing' | 'step_by_step' | 'case_study_format' | 'company_update' required

Taxonomy type; determines personal_post vs lead_magnet handling.

lead_magnet_keywordstring

Comment-trigger keyword; REQUIRED for lead_magnet types, must match the CTA in the body.

account_idstring uuid

LinkedIn account UUID to attribute the post to (getLinkedInAccounts).

Response

The result of calling this tool.

dataunknown required
errorunknown required

Changes

No recorded changes to this operation across all 3 revisions of this API.