Get poll
get_pollRetrieve a poll from Beehiiv using publication and poll IDs; expand results with vote stats, recent responses, or trivia answer.
Instructions
Get poll. Reads account data. OAuth integrations require polls: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>",
"poll_id": "<poll_id>"
},
"name": "get_poll"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| expand | No | Optionally expand the response to include additional data. `stats` - Returns aggregate vote counts per choice and total completions. `poll_responses` - Returns up to 10 most recent subscriber responses. Use /polls/{pollId}/responses for paginated access to all responses. `trivia_answer` - Returns the correct answer for trivia-type polls. | |
| account | No | Named private account from BEEHIIV_ACCOUNTS. Defaults to BEEHIIV_DEFAULT_ACCOUNT or the first configured account. | |
| poll_id | Yes | The prefixed ID of the poll object | |
| publication_id | Yes | The prefixed ID of the publication object |