Get newsletter list subscription
get_newsletter_list_subscriptionRetrieve details for a specific newsletter list subscription by publication, list, and subscription IDs to inspect subscription data.
Instructions
Get newsletter list subscription. Reads account data. OAuth integrations require newsletter_lists:read.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"publication_id": "<publication_id>",
"newsletter_list_id": "<newsletter_list_id>",
"newsletter_list_subscription_id": "<newsletter_list_subscription_id>"
},
"name": "get_newsletter_list_subscription"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account | No | Named private account from BEEHIIV_ACCOUNTS. Defaults to BEEHIIV_DEFAULT_ACCOUNT or the first configured account. | |
| publication_id | Yes | The prefixed ID of the publication object | |
| newsletter_list_id | Yes | The prefixed ID of the newsletter list object | |
| newsletter_list_subscription_id | Yes | The prefixed ID of the newsletter list subscription object |