You can wire the beehiiv node into an AI agent as a tool provider: the agent calls the operations you allow. See Agent tools.
Credentials
Connect beehiiv under Credentials in the node settings. See Connecting credentials for the general flow. Enter the values manually when creating the credential. Get your credentials here.Operations
Automations
| Operation | ID | Description | Trigger |
|---|---|---|---|
| Add Subscriber to Automation | add_to_automation | Enroll a subscriber into an automation journey. | |
| Get Automation | get_automation | Retrieve a single automation by ID. | |
| List Automations | list_automations | List automation flows for a publication. |
Custom fields
| Operation | ID | Description | Trigger |
|---|---|---|---|
| Create Custom Field | create_custom_field | Define a new custom field on subscribers. | |
| Delete Custom Field | delete_custom_field | Delete a custom subscriber field. | |
| List Custom Fields | list_custom_fields | List custom subscriber fields. |
Lists & polls
| Operation | ID | Description | Trigger |
|---|---|---|---|
| Get Poll | get_poll | Retrieve a single poll. | |
| Get Poll Responses | get_poll_responses | List responses for a poll. | |
| List Newsletter Lists | list_newsletter_lists | List newsletter lists (multi-list feature, beta). | |
| List Polls | list_polls | List polls and their responses. |
Posts
| Operation | ID | Description | Trigger |
|---|---|---|---|
| Create Post | create_post | Create a draft/scheduled post for a publication. | |
| Delete Post | delete_post | Delete a post. | |
| Get Post | get_post | Retrieve a single post. | |
| Get Post Stats | get_post_stats | Retrieve open/click/engagement stats for a post. | |
| List Posts | list_posts | List newsletter posts for a publication. | |
| Update Post | update_post | Update an existing post’s content or scheduling. |
Publications
| Operation | ID | Description | Trigger |
|---|---|---|---|
| Get Publication | get_publication | Retrieve a single publication. | |
| List Publications | list_publications | List all publications associated with the API key. |
Segments
| Operation | ID | Description | Trigger |
|---|---|---|---|
| Delete Segment | delete_segment | Delete a segment. | |
| Get Segment | get_segment | Retrieve a single segment. | |
| List Segment Subscribers | list_segment_subscribers | List subscribers matching a segment. | |
| List Segments | list_segments | List all segments for a publication. |
Subscriptions
| Operation | ID | Description | Trigger |
|---|---|---|---|
| Add Subscription Tag | add_subscription_tag | Attach tags to a subscriber. | |
| Bulk Create Subscriptions | bulk_create_subscriptions | Import many subscribers in one async job. | |
| Create Subscription | create_subscription | Add a new subscriber to a publication. | |
| Delete Subscription | delete_subscription | Remove a subscriber from the publication. | |
| Get Subscription | get_subscription | Retrieve a single subscription by its prefixed ID. | |
| Get Subscription by Email | get_subscription_by_email | Look up a subscriber by email address. | |
| List Subscriptions | list_subscriptions | List all subscriptions for a publication. | |
| Update Subscription | update_subscription | Update a subscriber’s tier, custom fields, or status. |
Tiers & referrals
| Operation | ID | Description | Trigger |
|---|---|---|---|
| Get Referral Program | get_referral_program | Retrieve referral program milestones/rewards. | |
| List Tiers | list_tiers | List paid subscription tiers. |
Webhooks
| Operation | ID | Description | Trigger |
|---|---|---|---|
| Create Webhook | create_webhook | Subscribe an endpoint URL to event types. | |
| Delete Webhook | delete_webhook | Remove a webhook subscription. | |
| Get Webhook | get_webhook | Retrieve a single webhook endpoint. | |
| List Webhooks | list_webhooks | List configured webhook endpoints. |
Other
| Operation | ID | Description | Trigger |
|---|---|---|---|
| On beehiiv Event (Any) | on_beehiiv_event | Trigger: fires on any beehiiv event (catch-all). | Yes |
| On New Subscriber | on_subscriber_created | Trigger: fires when a new subscriber is created. | Yes |
| On Newsletter List Event | on_newsletter_list_event | Trigger: fires when a subscriber joins, leaves, pauses, or resumes a newsletter list. | Yes |
| On Post Scheduled | on_post_scheduled | Trigger: fires when a post is scheduled for future delivery. | Yes |
| On Post Sent | on_post_sent | Trigger: fires when a post is sent to subscribers. | Yes |
| On Post Updated | on_post_updated | Trigger: fires when an existing post is updated. | Yes |
| On Subscriber Confirmed | on_subscriber_confirmed | Trigger: fires when a subscriber confirms their email (double opt-in). | Yes |
| On Subscriber Unsubscribed | on_subscription_deleted | Trigger: fires when a subscriber unsubscribes or is deleted. | Yes |
| On Subscription Downgraded | on_subscription_downgraded | Trigger: fires when a subscription is downgraded. | Yes |
| On Subscription Paused | on_subscription_paused | Trigger: fires when a subscription is paused. | Yes |
| On Subscription Resumed | on_subscription_resumed | Trigger: fires when a paused subscription is resumed. | Yes |
| On Subscription Upgraded | on_subscription_upgraded | Trigger: fires when a subscription is upgraded to a paid tier. | Yes |
| On Survey Response | on_survey_response | Trigger: fires when a subscriber submits a survey response. | Yes |
| On Tier Changed | on_tier_changed | Trigger: fires when a subscription tier is created, deleted, paused, or resumed. | Yes |