Delete newsletter list
delete_newsletter_listRemove a newsletter list from a Beehiiv publication when the user confirms the action. Requires publication and newsletter list IDs and sets confirm=true.
Instructions
Delete newsletter list. Changes account state and requires confirm=true for the user-requested action. OAuth integrations require newsletter_lists:write.
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>"
},
"name": "delete_newsletter_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account | No | Named private account from BEEHIIV_ACCOUNTS. Defaults to BEEHIIV_DEFAULT_ACCOUNT or the first configured account. | |
| confirm | No | Set true only when the user asked for exactly this action. | |
| publication_id | Yes | The prefixed ID of the publication object | |
| newsletter_list_id | Yes | The prefixed ID of the newsletter list object |