Beehiiv

Beehiiv integration (Marketing, Productivity). Imported from open-connector.

API key6 toolshttps://api.beehiiv.com

GET

beehiiv_list_publications

List Beehiiv publications associated with the API key, with optional sorting and expansion.

/v2/publications

5 parameters

Param	Type	Required	Description
expand	array	optional	Publication fields to expand in the Beehiiv response.
limit	integer	optional	Maximum number of objects to return. Beehiiv documents a range from 1 to 100 an…
page	integer	optional	Offset-based page number for Beehiiv pagination.
direction	string	optional	Sort direction for the Beehiiv request.
orderBy	string	optional	Field used to sort Beehiiv publications.

GET

beehiiv_get_publication

Fetch one Beehiiv publication by ID with optional statistics expansion.

/v2/publications/{publicationId}

2 parameters

Param	Type	Required	Description
publicationId	string	required	Beehiiv publication ID to retrieve.
expand	array	optional	Publication fields to expand in the Beehiiv response.

GET

beehiiv_list_posts

List Beehiiv posts for a publication with documented filters and optional expansions.

/v2/publications/{publicationId}/posts

14 parameters

Param	Type	Required	Description
publicationId	string	required	Beehiiv publication ID whose posts should be listed.
expand	array	optional	Post fields to expand in the Beehiiv response. HTML content expansions can make…
audience	string	optional	Audience filter for returned posts.
platform	string	optional	Platform filter for returned posts.
status	string	optional	Status filter for returned posts.
contentTags	array	optional	Content tags used to filter returned posts.
slugs	array	optional	Post slugs used to filter returned posts.
authors	array	optional	Author names used to filter returned posts.
premiumTiers	array	optional	Premium tier display names used to filter returned posts and expanded content.
limit	integer	optional	Maximum number of objects to return. Beehiiv documents a range from 1 to 100 an…
page	integer	optional	Offset-based page number for Beehiiv pagination.
orderBy	string	optional	Field used to sort Beehiiv posts.
direction	string	optional	Sort direction for the Beehiiv request.
hiddenFromFeed	string	optional	Filter by whether posts are hidden from the feed.

GET

beehiiv_get_post

Fetch one Beehiiv post by ID with optional statistics or content expansion.

/publications/{publicationId}/posts/{postId}

4 parameters

Param	Type	Required	Description
publicationId	string	required	Beehiiv publication ID that owns the post.
postId	string	required	Beehiiv post ID to retrieve.
expand	array	optional	Post fields to expand in the Beehiiv response. HTML content expansions can make…
premiumTiers	array	optional	Premium tier display names used to scope expanded post content.

GET

beehiiv_list_subscriptions

List Beehiiv subscriptions for a publication with cursor pagination and documented filters.

/publications/{publicationId}/subscriptions

13 parameters

Param	Type	Required	Description
publicationId	string	required	Beehiiv publication ID whose subscriptions should be listed.
expand	array	optional	Subscription fields to expand in the Beehiiv response.
status	string	optional	Status filter for returned subscriptions.
tier	string	optional	Tier filter for returned subscriptions.
premiumTiers	array	optional	Premium tier names used to filter returned subscriptions.
premiumTierIds	array	optional	Premium tier IDs used to filter returned subscriptions.
limit	integer	optional	Maximum number of objects to return. Beehiiv documents a range from 1 to 100 an…
cursor	string	optional	Cursor token for cursor-based pagination.
page	integer	optional	Offset-based page number for Beehiiv pagination.
email	string	optional	Email address used to find a matching subscription.
orderBy	string	optional	Field used to sort Beehiiv subscriptions.
direction	string	optional	Sort direction for the Beehiiv request.
creationDate	string	optional	Creation date filter in YYYY/MM/DD format.

GET

beehiiv_get_subscription

Fetch one Beehiiv subscription by ID with optional expansions.

/publications/{publicationId}/subscriptions/{subscriptionId}

3 parameters

Param	Type	Required	Description
publicationId	string	required	Beehiiv publication ID that owns the subscription.
subscriptionId	string	required	Beehiiv subscription ID to retrieve.
expand	array	optional	Subscription fields to expand in the Beehiiv response.