n8n-nodes-beehiiv

This package contains an n8n community node for posting to Beehiiv newsletters.

⚠️ Important Requirements

This node requires a Beehiiv Enterprise plan to function.

The Create Post operation uses Beehiiv's Send API, which is only available on Enterprise plans. If you do not have an Enterprise plan, you will receive a SEND_API_DISABLED error when attempting to use this node.

• Required Plan: Beehiiv Enterprise
• Required Feature: Send API must be enabled for your workspace
• Upgrade: Visit app.beehiiv.com/settings/billing to upgrade

If you're already on an Enterprise plan but still seeing errors, contact Beehiiv support to ensure the Send API feature is enabled for your workspace.

Installation

1. Navigate to your n8n installation directory
2. Run npm install n8n-nodes-beehiiv
3. Restart n8n

Credentials

To use this node, you'll need to configure Beehiiv API credentials:

1. API Key: Your Beehiiv API key (found in your Beehiiv account settings)
2. Publication ID: Your Beehiiv publication ID

You can find these in your Beehiiv dashboard under Settings > API.

Usage

Create Post

The node allows you to create posts in your Beehiiv newsletter with the following options:

• Title: The title of the post (required)
• Content: The content of the post - can be HTML or plain text (required)
• Preview Text: Preview text shown in email clients (optional)
• Send At: Schedule the post to be sent at a specific date and time (optional)
• Status: Set the post status to "Draft" or "Published" (default: Draft)
• Content Format: Specify if content is "HTML" or "Plain Text" (default: HTML)

Example

1. Add the Beehiiv node to your workflow
2. Configure your Beehiiv API credentials
3. Set the operation to "Create Post"
4. Enter your post title and content
5. Configure any additional fields as needed
6. Execute the workflow

API Documentation

For more information about the Beehiiv API, visit: https://developers.beehiiv.com

Development

Running Tests

# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

# Run tests with coverage
npm run test:coverage

Building

# Build the node
npm run build

Linting

# Check for linting errors
npm run lint

# Fix linting errors
npm run lintfix

License

MIT