beehiiv Developer Documentation

Retrieve all publications in the workspace that have a subscription for the specified email address. The workspace is determined by the provided API key.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

emailstringRequired

The email address to search for subscriptions

Response

publication_idstringformat: "^(pub_[0-9a-fA-F\-]+)$"

The prefixed ID of the publication

publication_namestring

The name of the publication

1	import requests
2
3	url = "https://api.beehiiv.com/v2/workspaces/publications/by_subscription_email/bruce.wayne%40wayneenterprise.com"
4
5	headers = {"Authorization": "Bearer <token>"}
6
7	response = requests.get(url, headers=headers)
8
9	print(response.json())

1	[
2	{
3	"publication_id": "pub_00000000-0000-0000-0000-000000000000",
4	"publication_name": "Publication Name 1"
5	},
6	{
7	"publication_id": "pub_11111111-1111-1111-1111-111111111111",
8	"publication_name": "Publication Name 2"
9	}
10	]

Get publications by subscription email

Authentication

Path parameters

Response

Errors