beehiiv

Manage beehiiv newsletters: publications, posts, subscribers, segments, automations. Exposes 34 actions covering the full API surface the agent needs - read and write.

What it can do

Method	What it does
beehiiv_get_publication	Get publication (newsletter) info - GET /publications/{id}.
beehiiv_list_subscribers	List newsletter subscribers - GET /publications/{id}/subscribers.
beehiiv_get_subscriber	Get one subscriber - GET /publications/{id}/subscribers/{subscriber_id}.
beehiiv_create_subscriber	Add a subscriber - POST /publications/{id}/subscribers.
beehiiv_update_subscriber	Update a subscriber - PATCH /publications/{id}/subscribers/{subscriber_id}.
beehiiv_delete_subscriber	Delete a subscriber - DELETE /publications/{id}/subscribers/{subscriber_id}.
beehiiv_list_posts	List posts - GET /publications/{id}/posts.
beehiiv_get_post	Get one post - GET /publications/{id}/posts/{post_id}.
beehiiv_create_post	Create a post - POST /publications/{id}/posts.
beehiiv_update_post	Update a post - PATCH /publications/{id}/posts/{post_id}.
beehiiv_publish_post	Publish a post immediately - POST /publications/{id}/posts/{post_id}/publish.
beehiiv_delete_post	Delete a post - DELETE /publications/{id}/posts/{post_id}.
beehiiv_get_post_stats	Get post analytics - GET /publications/{id}/posts/{post_id}/stats.
beehiiv_list_emails	List emails/campaigns - GET /publications/{id}/emails.
beehiiv_get_email	Get one email/campaign - GET /publications/{id}/emails/{email_id}.
beehiiv_get_email_stats	Get email analytics - GET /publications/{id}/emails/{email_id}/stats.
beehiiv_list_referrals	List referrals - GET /publications/{id}/referrals.
beehiiv_get_referral	Get one referral - GET /publications/{id}/referrals/{referral_id}.
beehiiv_list_segments	List subscriber segments - GET /publications/{id}/segments.
beehiiv_get_segment	Get one segment - GET /publications/{id}/segments/{segment_id}.
beehiiv_create_segment	Create a segment - POST /publications/{id}/segments.
beehiiv_update_segment	Update a segment - PATCH /publications/{id}/segments/{segment_id}.
beehiiv_delete_segment	Delete a segment - DELETE /publications/{id}/segments/{segment_id}.
beehiiv_list_automations	List automations - GET /publications/{id}/automations.
beehiiv_get_automation	Get one automation - GET /publications/{id}/automations/{automation_id}.
beehiiv_create_automation	Create an automation - POST /publications/{id}/automations.
beehiiv_update_automation	Update an automation - PATCH /publications/{id}/automations/{automation_id}.
beehiiv_delete_automation	Delete an automation - DELETE /publications/{id}/automations/{automation_id}.
beehiiv_list_bounces	List bounces - GET /publications/{id}/bounces.
beehiiv_process_bounce	Mark subscriber as bounced - POST /publications/{id}/bounces.
beehiiv_get_publication_stats	Get publication-wide analytics - GET /publications/{id}/stats.
beehiiv_list_webhooks	List webhooks - GET /publications/{id}/webhooks.
beehiiv_create_webhook	Create a webhook - POST /publications/{id}/webhooks.
beehiiv_delete_webhook	Delete a webhook - DELETE /publications/{id}/webhooks/{webhook_id}.

How to get credentials

This connector uses an API key / token. Create one in the provider dashboard, then paste it into FlyMyAI:

• BEEHIIV_API_KEY - beehiiv - Settings - Integrations - API. (https://app.beehiiv.com/settings/integrations/api)
• BEEHIIV_PUBLICATION_ID - beehiiv publication id (pub_...).

Fields to fill in FlyMyAI

FlyMyAI field	Where it comes from
BEEHIIV_API_KEY	beehiiv - Settings - Integrations - API.
BEEHIIV_PUBLICATION_ID	beehiiv publication id (pub_...).

Troubleshooting

• 401 Unauthorized / 403 Forbidden - the token is wrong, expired, or missing a required scope - regenerate it.
• 429 Too Many Requests - you hit the provider rate limit; retry after a short backoff.
• Unexpected 4xx on writes - double-check required fields; the agent confirms before write actions.

Links

• beehiiv API documentation

❤️We love our partners - FlyMy.AI builds with the best. Thanks, beehiiv!