# 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](https://developers.beehiiv.com)