Create newsletter list subscription OAuth Scope: newsletter_lists:write

POST

https://api.beehiiv.com/v2/publications/:publicationId/newsletter_lists/:newsletterListId/subscriptions

Subscribe a subscription to a newsletter list. Accepts either a subscription_id or email to identify the subscription.

This endpoint only enrolls existing subscriptions. To create a new subscription and enroll it in one or more newsletter lists in a single call, use the Create subscription endpoint and pass the newsletter_list_ids parameter.

Subscribe a subscription to a newsletter list. Accepts either a subscription_id or email to identify the subscription. <Info> This endpoint only enrolls **existing** subscriptions. To create a new subscription **and** enroll it in one or more newsletter lists in a single call, use the [Create subscription](/api-reference/subscriptions/create) endpoint and pass the `newsletter_list_ids` parameter. </Info>

$	curl -X POST https://api.beehiiv.com/v2/publications/pub_00000000-0000-0000-0000-000000000000/newsletter_lists/nl_list_00000000-0000-0000-0000-000000000000/subscriptions \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"subscription_id": "sub_00000000-0000-0000-0000-000000000000"
>	}'

1	{
2	"data": {
3	"id": "nl_list_sub_00000000-0000-0000-0000-000000000000",
4	"newsletter_list_id": "nl_list_00000000-0000-0000-0000-000000000000",
5	"subscription_id": "sub_00000000-0000-0000-0000-000000000000",
6	"status": "active",
7	"created_at": 1672531200,
8	"subscribed_at": 1672531200,
9	"unsubscribed_at": null
10	}
11	}

Authentication

Path parameters

Request

Response

Errors