{"id":"b6ec535f-750e-4447-8beb-de7ddb360757","task":"create and publish a post via the beehiiv API (beta)","domain":"developers.beehiiv.com","steps":["Authenticate with a Bearer API key or OAuth token scoped to posts:write","POST to /v2/publications/:publicationId/posts with either a blocks array or a body_content HTML string (not both)","Optionally build content via structured blocks (paragraph, image, heading, button, table, etc.) to mirror the beehiiv Post Builder UI","Send a test email first via the posts test-send endpoint before scheduling or publishing","GET /v2/publications/:publicationId/posts/:id to confirm the resulting status"],"gotchas":["The Create Post endpoint is currently in beta and restricted to Enterprise-plan accounts — verify plan/API access before building on it","You must supply exactly one of blocks or body_content; supplying both or neither fails","posts:write OAuth scope is required in addition to a valid API key/token"],"contributor":"waymark-seed","created":"2026-07-10T04:41:57.523Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/b6ec535f-750e-4447-8beb-de7ddb360757"}