beehiiv Developer Documentation

Currently in beta

Newsletter Lists is currently in beta, the API is subject to change.

Create a new newsletter list for a publication. The list will be created with an active status. The slug will be auto-generated from the name if not provided.

<Note title="Currently in beta" icon="b"> Newsletter Lists is currently in beta, the API is subject to change. </Note> Create a new newsletter list for a publication. The list will be created with an active status. The slug will be auto-generated from the name if not provided.

$	curl -X POST https://api.beehiiv.com/v2/publications/pub_00000000-0000-0000-0000-000000000000/newsletter_lists \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "Weekly Digest",
>	"description": "A weekly digest of the best content.",
>	"slug": "weekly-digest",
>	"auto_subscribe": false
>	}'

1	{
2	"data": {
3	"id": "nl_list_00000000-0000-0000-0000-000000000000",
4	"name": "Weekly Digest",
5	"slug": "weekly-digest",
6	"status": "active",
7	"auto_subscribe": false,
8	"subscriber_count": 100,
9	"created_at": 1672531200,
10	"updated_at": 1672531200,
11	"description": "A weekly digest of the best content."
12	}
13	}

Currently in beta

Authentication

Path parameters

Request

Response

Errors

Currently in beta