View as Markdown
Beehiiv icon

Beehiiv ACTION

Create Post

Create a new post (newsletter draft). Pass HTML content in the content parameter. The post is created as a draft by default — set status: "confirmed" to publish immediately. Use content tags to categorize the post. Use Get Publication Info to get the publication ID. See the documentation
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Beehiiv account once, then configure and run Create Post from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "beehiiv-create-post",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    beehiiv: { authProvisionId: "apn_xxxxxxx" },
    publicationId: "Publication ID",
    title: "Title",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Post inputs
Property Type Description
publicationId Publication ID string
The publication ID. Use Get Publication Info to find this.
Required
title Title string
The title of the post.
Required
subtitle Subtitle string
The subtitle/preview text of the post.
Optional
content Content string
The HTML content of the post body. Example: <p>Hello subscribers!</p>.
Required
slug Slug string
URL slug for the post. Auto-generated from title if omitted.
Optional
authors Authors string[]
Author names for the post.
Optional
contentTags Content Tags string[]
Tags to categorize the post.
Optional
status Status string
Post status. draft (default) or confirmed (published).
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
beehiiv-create-post
Version
0.0.2
App
Beehiiv
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes