Run a real election or board vote: price it, check state HOA rules, draft the ballot and voter list.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional. Clients that support MCP OAuth sign the person in automatically on the first account tool call. Clients that cannot sign in send a Bearer vd_agent_... key from https://vote.direct/settings/agents instead.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Add eligible voters (email, optional name and unit) to a DRAFT election in the connected account, through the import the voter list page uses. Idempotent: people already on the list are skipped, a voter listed twice is added once, and rows that cannot be added are named by row number. Returns counts, never the rows, and the updated price. For a published election, voters are added by the organizer on the election page, because a larger list can change the price.
The eligible voters (the roster), one per owner/member. Email addresses only; people reached by text or mail are added by the organizer on the election page.
The draft's id or slug.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Add eligible voters (email, optional name and unit) to a DRAFT election in the connected account, through the import the voter list page uses. Idempotent: people already on the list are skipped, a voter listed twice is added once, and rows that cannot be added are named by row number. Returns counts, never the rows, and the updated price. For a published election, voters are added by the organizer on the election page, because a larger list can change the price.
| Argument | Type | Description |
|---|---|---|
| voters* | array | The eligible voters (the roster), one per owner/member. Email addresses only; people reached by text or mail are added by the organizer on the election page. |
| election* | string | The draft's id or slug. |
{
"type": "object",
"required": [
"election",
"voters"
],
"properties": {
"voters": {
"type": "array",
"items": {
"type": "object",
"required": [
"email"
],
"properties": {
"name": {
"type": "string",
"description": "Owner or member name, shown on the roster."
},
"unit": {
"type": "string",
"description": "Unit, lot or address label, e.g. \"Unit 4B\"."
},
"email": {
"type": "string",
"format": "email"
}
}
},
"maxItems": 5000,
"description": "The eligible voters (the roster), one per owner/member. Email addresses only; people reached by text or mail are added by the organizer on the election page."
},
"election": {
"type": "string",
"description": "The draft's id or slug."
}
}
}Honest head-to-head between vote.direct and a named competitor (including the cases where the competitor is the better choice), with published prices checked on the competitor’s own pages, a vendor disclosure, and the price-beat offer where the competitor is a paid election platform. Without a competitor, returns which-platform-for-which-need guidance.
| Argument | Type | Description |
|---|---|---|
| competitor | string | Competitor to compare against (optional) |
{
"type": "object",
"required": [],
"properties": {
"competitor": {
"enum": [
"electionbuddy",
"opavote",
"simply-voting",
"vote-hoa-now",
"hoaballot",
"associationvoting",
"surveymonkey",
"google-forms",
"helios-voting",
"paper-ballots"
],
"type": "string",
"description": "Competitor to compare against (optional)"
}
}
}A secure Stripe payment page for a DRAFT election's fee, for the person you act for to pay by card. It creates the page and charges nothing: hand the person the link. The page asks for exactly the price get_election_price reports. Publishing follows the payment either way: the election's page, where Stripe returns them, publishes it once the payment lands, and publish_election with after_payment: true publishes it from here or answers already_published. Refused when nothing is owed (free, already paid, or covered by a plan) and when the prepaid balance covers the fee, because publishing then takes it without a card.
| Argument | Type | Description |
|---|---|---|
| election* | string | The election's id or slug, from list_elections or create_election_draft. |
{
"type": "object",
"required": [
"election"
],
"properties": {
"election": {
"type": "string",
"description": "The election's id or slug, from list_elections or create_election_draft."
}
}
}Create a DRAFT election in the connected account: the ballot, schedule, verification, secrecy, results visibility, optional quorum and state-law checks, and optionally the voter list (emails). A draft charges nothing and contacts nobody. Returns the draft's id, the draft as saved, what still blocks publishing, the exact price, and the finish link where the person reviews, pays if needed, and publishes. Create it once and change it with update_election_draft: an account can create 10 elections an hour. Ask the person for anything you do not know (closing date and time zone, seats, candidates) rather than guessing: this is a binding vote.
| Argument | Type | Description |
|---|---|---|
| state | string | Two-letter US state code of the association (e.g. CA). Turns on that state's election-law checks before publishing. |
| title* | string | Election title voters see, e.g. "2026 Board of Directors Election". |
| quorum | object | Optional quorum: {type: "percentage" | "count", threshold}. E.g. {type: "percentage", threshold: 25} means a quarter of eligible voters must vote. |
| voters | array | The eligible voters (the roster), one per owner/member. Email addresses only; people reached by text or mail are added by the organizer on the election page. |
| results | string | after_close (default): voters see results once voting closes. live: running totals while voting is open. owner_only: only the organizer sees results. |
| opens_at | string |
Create a free, anonymous survey in the connected account and publish it (or save it as a draft with publish: false). Surveys are for feedback, not binding votes: anyone with the link can answer and respondents are not verified. For anything binding (a board election, a bylaw amendment, an assessment) use create_election_draft. Question types: single (pick one), multiple (checkboxes), yes_no, rating (1-5 by default; settings {scale: "nps"} makes a 0-10 Net Promoter Score), ranking, open_text. Returns the share link.
| Argument | Type | Description |
|---|---|---|
| title* | string | |
| publish | boolean | Publish now (default true) or save a draft. |
| settings | object | Optional: showResultsDuring, showResultsAfter, requireAllQuestions, collectEmail, collectName. |
| timezone | string | IANA timezone for the close time. Defaults to UTC. |
| closes_at | string | Optional close time, ISO 8601. |
| questions* | array | |
| description | string |
{
"type": "object",
"required": [
"title",
"questions"
],
"properties": {
"title": {
"type": "string"
},
"publish": {
"type": "boolean",
"description": "Publish now (default true) or save a draft."
},
"settings": {
"type": "object",
"description": "Optional: showResultsDuring, showResultsAfter, requireAllQuestions, collectEmail, collectName."
},
"timezone": {
"type": "string",
"description": "IANA timezone for the close time. Defaults to UTC."
},
"closes_at": {
"type": "string",
"format": "date-time",
"description": "Optional close time, ISO 8601."
},
"questions": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"text"
],
"properties": {
"text": {
"type": "string"
},
"type": {
"enum": [
"single",
"multiple",
"yes_no",
"rating",
"ranking",
"open_text"
],
"type": "string"
},
"options": {
"type": "array",
"items": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
}
}
},
"description": "Required (at least 2) for single, multiple and ranking."
},
"required": {
"type": "boolean"
},
"settings": {
"type": "object",
"description": "Optional: minRating/maxRating/ratingLabels for rating, scale \"nps\", variant \"short\"|\"email\"|\"number\"|\"date\"|\"phone\" for open_text, allowWriteIn for single/multiple, maxSelections for multiple."
},
"description": {
"type": "string"
}
}
},
"minItems": 1
},
"description": {
"type": "string"
}
}
}One election or survey in the connected account, as it is saved now: the schedule in its time zone, every question with its type, seats and options (in the words create_election_draft takes), the settings, the voter list as counts, ballots cast, turnout and quorum, and links. For a DRAFT election it also reports what still blocks publishing, what is worth checking, the exact price the publish step would charge, and who pays it (free, plan, prepaid balance, or card at the finish link). Per-question results are on the election page link; this tool reports counts only, never a voter's name, email or phone number.
| Argument | Type | Description |
|---|---|---|
| election* | string | The election's id or slug, from list_elections or create_election_draft. |
{
"type": "object",
"required": [
"election"
],
"properties": {
"election": {
"type": "string",
"description": "The election's id or slug, from list_elections or create_election_draft."
}
}
}The price of one election in the connected account as it stands, from the same function the payment page and the publish step charge: its voter count, the tier, what the total is made of (government ID, texts for a small roster), and who pays it now (free, plan, prepaid balance, or card). Ask again after the voter list changes. Changes nothing.
| Argument | Type | Description |
|---|---|---|
| election* | string | The election's id or slug, from list_elections or create_election_draft. |
{
"type": "object",
"required": [
"election"
],
"properties": {
"election": {
"type": "string",
"description": "The election's id or slug, from list_elections or create_election_draft."
}
}
}Whether a DRAFT election in the connected account can publish now: the checks the publish button runs (schedule, ballot, voter list, state rules, size), each blocker in the words publish would refuse with, warnings a board should hear (voting closes inside the state's notice period, no quorum on an HOA or condo, voters the emailed ballot cannot reach), the exact price and who pays it. Fixing one blocker can show the next, so ask again after each fix. Changes nothing.
| Argument | Type | Description |
|---|---|---|
| election* | string | The election's id or slug, from list_elections or create_election_draft. |
{
"type": "object",
"required": [
"election"
],
"properties": {
"election": {
"type": "string",
"description": "The election's id or slug, from list_elections or create_election_draft."
}
}
}governance.center, the second product from this team: the Board Office for a volunteer-run HOA, condo, nonprofit board, club or congregation. Returns the annual price for a given community size from the same constants Stripe bills, what every band includes, what is priced per use, what the product deliberately does not do, and the support line. Annual price first; the monthly figure is only an explainer.
| Argument | Type | Description |
|---|---|---|
| members | integer | How many members, owners or units the community has. Returns the band that covers them. |
{
"type": "object",
"required": [],
"properties": {
"members": {
"type": "integer",
"minimum": 1,
"description": "How many members, owners or units the community has. Returns the band that covers them."
}
}
}Factual overview of vote.direct: free tier and pricing model, verification ladder, ballot-secrecy modes, the dispute-evidence pack (audit trail, results certificate, receipts), voting channels, question types, the full feature list with the no-tier-lock rule, who owns and runs the company, the founder's direct line, and where to read more.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Exact, current vote.direct pricing for an election: flat rate by voter count (email verification included, SMS on paid elections), optional government-ID and mailed-letter add-ons, promotional pricing status, whether a subscription would beat paying per election, and the price-beat offer (vote.direct beats a lower quote from another provider for the same self-serve online election). Same constants the product bills against.
| Argument | Type | Description |
|---|---|---|
| voters* | integer | How many voters will be invited |
| gov_id_voters | integer | Voters needing assisted government-ID verification (optional) |
| mailed_letters | integer | Mailed access letters to send (optional) |
| elections_per_year | integer | If provided, adds the yearly total for that many elections of this size |
{
"type": "object",
"required": [
"voters"
],
"properties": {
"voters": {
"type": "integer",
"minimum": 1,
"description": "How many voters will be invited"
},
"gov_id_voters": {
"type": "integer",
"minimum": 0,
"description": "Voters needing assisted government-ID verification (optional)"
},
"mailed_letters": {
"type": "integer",
"minimum": 0,
"description": "Mailed access letters to send (optional)"
},
"elections_per_year": {
"type": "integer",
"minimum": 1,
"description": "If provided, adds the yearly total for that many elections of this size"
}
}
}The complete third-party review record for vote.direct: every published Capterra and Trustpilot review quoted verbatim with links, including the honest caveats (small record, TrustScore explanation, which reviewers had actually run an election, and anything a reviewer received from us).
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Stored HOA/condo voting-rule summary for any US state: whether electronic voting is expressly allowed, key statutes with citations, quorum, notice and proxy rules, and whether vote.direct may serve as inspector of elections there. Summaries support review; they are not legal advice.
| Argument | Type | Description |
|---|---|---|
| state* | string | State name, two-letter abbreviation, or slug (e.g. "Texas", "TX", "texas") |
{
"type": "object",
"required": [
"state"
],
"properties": {
"state": {
"type": "string",
"description": "State name, two-letter abbreviation, or slug (e.g. \"Texas\", \"TX\", \"texas\")"
}
}
}Elections and surveys in the connected vote.direct account, newest first: id, slug, title, kind (election or survey), status (draft, scheduled, live, closed), schedule, voters and ballots cast, and the links to hand the person.
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many to return. Defaults to 20. |
| status | string | Only this status. Defaults to all. |
{
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "How many to return. Defaults to 20."
},
"status": {
"enum": [
"draft",
"scheduled",
"live",
"closed",
"all"
],
"type": "string",
"description": "Only this status. Defaults to all."
}
}
}Publish a DRAFT election in the connected account, running every check the publish button runs (ballot, schedule, voter list, state law, price) and charging the price from the account's prepaid balance or plan. Free elections (up to 25 voters) publish at no cost. If the balance does not cover it, nothing is charged and the person pays by card, at the finish link or on a payment page from create_checkout_link. Publishing follows a card payment either way: the page the person returns to from Stripe publishes once the payment lands, or call this with after_payment: true, which waits for the payment and publishes without a second charge, never drawing on the balance as well. An election that is already published and paid for answers status already_published with its links, not a refusal. Once published it emails voters their ballots when it can send as the organizer; through an assistant connection it usually cannot, so the result says whether ballots were emailed and, if not, links the election page where the organizer sends them. Confirm with the person before calling this; it can spend their money.
| Argument | Type | Description |
|---|---|---|
| election* | string | The election's id or slug, from list_elections or create_election_draft. |
| after_payment | boolean | true once the person has paid by card (on a create_checkout_link page or at the finish link): waits up to 15 seconds for the payment to reach vote.direct, then publishes without charging anything, or answers already_published if the page they returned to has published it. Leave it out otherwise. |
{
"type": "object",
"required": [
"election"
],
"properties": {
"election": {
"type": "string",
"description": "The election's id or slug, from list_elections or create_election_draft."
},
"after_payment": {
"type": "boolean",
"description": "true once the person has paid by card (on a create_checkout_link page or at the finish link): waits up to 15 seconds for the payment to reach vote.direct, then publishes without charging anything, or answers already_published if the page they returned to has published it. Leave it out otherwise."
}
}
}Take voters off a DRAFT election in the connected account, by email address or by unit. A voter goes when their email is named, or when every unit they hold is named, so nobody loses a unit by accident; the contact book is not touched. Returns how many were taken off and how many of those named are not on the list, never the rows, and the updated price.
| Argument | Type | Description |
|---|---|---|
| units | array | Units, lots or address labels whose voters to take off, e.g. "Unit 4B". |
| emails | array | Email addresses of the voters to take off. |
| election* | string | The draft's id or slug. |
{
"type": "object",
"required": [
"election"
],
"properties": {
"units": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 5000,
"description": "Units, lots or address labels whose voters to take off, e.g. \"Unit 4B\"."
},
"emails": {
"type": "array",
"items": {
"type": "string",
"format": "email"
},
"maxItems": 5000,
"description": "Email addresses of the voters to take off."
},
"election": {
"type": "string",
"description": "The draft's id or slug."
}
}
}Build a complete election (ballot, schedule, verification, voter emails) for a person who does not have a vote.direct account yet, and get the link where they claim it: they open it, create an account with their email, and the election appears in their dashboard ready to review and publish. Nothing is charged and no voter is contacted until they do. The link expires in 48 hours. For a person who has an account, or will sign in, create_election_draft works in their account directly.
| Argument | Type | Description |
|---|---|---|
| state | string | Two-letter US state code of the association (e.g. CA). Turns on that state's election-law checks before publishing. |
| title* | string | Election title voters see, e.g. "2026 Board of Directors Election". |
| quorum | object | Optional quorum: {type: "percentage" | "count", threshold}. E.g. {type: "percentage", threshold: 25} means a quarter of eligible voters must vote. |
| voters | array | The eligible voters (the roster), one per owner/member. Email addresses only; people reached by text or mail are added by the organizer on the election page. |
| results | string | after_close (default): voters see results once voting closes. live: running totals while voting is open. owner_only: only the organizer sees results. |
| opens_at | string | When voting opens, ISO 8601 with offset. Omit to open when published. |
Change a DRAFT election in the connected account: title, description, organization name, schedule and time zone, secret ballot, results visibility, quorum, and the ballot (add, remove or change questions, or replace them all). While nobody has paid for it, its state, community type, vote type and verification can change too. Fields mean what they mean in create_election_draft. Changes go through the election editor, so anything the election page would refuse is refused with its reason and nothing is half-changed where that can be checked first. Returns one plain sentence per change, written from the saved election, and what still blocks publishing. A published election is changed by the organizer on its page.
| Argument | Type | Description |
|---|---|---|
| patch* | object | Only the fields to change; every field means what it means in create_election_draft. At least one field. |
| election* | string | The draft's id or slug. |
{
"type": "object",
"required": [
"election",
"patch"
],
"properties": {
"patch": {
"type": "object",
"properties": {
"state": {
"type": "string",
"description": "Two-letter US state code of the association (e.g. CA). Turns on that state's election-law checks before publishing."
},
"title": {
"type": "string",
"description": "Election title voters see, e.g. \"2026 Board of Directors Election\"."
},
"quorum": {
"type": [
"object",
"null"
],
"required": [
"type",
"threshold"
],
"properties": {
"type": {
"enum": [
"percentage",
"count"
],
"type": "string"
},
"threshold": {
"type": "integer",
"minimum": 1
}
},
"description": "The quorum: {type: \"percentage\" | \"count\", threshold}. null removes it."
},
"results": {
"enum": [
"after_close",
"live",
"owner_only"
],
"type": "string",
"description": "after_close (default): voters see results once voting closes. live: running totals while voting is open. owner_only: only the organizer sees results."
},
"opens_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "When voting opens, ISO 8601 with offset. null opens voting when the election is published."
},
"timezone": {
"type": "string",
"description": "IANA timezone of the association, e.g. America/Denver. Voters see times in it."
},
"closes_at": {
"type": "string",
"format": "date-time",
"description": "When voting closes, ISO 8601 with offset, e.g. 2026-11-12T17:00:00-07:00. Must be in the future. Leave it out when nobody said: voting then closes at 5pm in `timezone` seven days from today, and the result says the exact time so it can be relayed and changed."
},
"questions": {
"type": "object",
"properties": {
"add": {
"type": "array",
"items": {
"type": "object",
"required": [
"text",
"type"
],
"properties": {
"text": {
"type": "string",
"description": "The question or race, e.g. \"Elect three directors\"."
},
"type": {
"enum": [
"single_choice",
"multiple_choice",
"yes_no",
"ranked_choice",
"approval",
"cumulative",
"open_text"
],
"type": "string",
"description": "single_choice: pick one. multiple_choice: pick up to `seats` (a multi-seat board race). yes_no: approve or reject a motion (Yes/No options are added automatically). ranked_choice: rank candidates; instant runoff for one seat, single transferable vote when seats > 1. approval: approve any number of candidates. cumulative: each voter spreads `seats` votes (minimum 2) across candidates, used where bylaws require cumulative voting. open_text: a written answer."
},
"seats": {
"type": "integer",
"minimum": 1,
"description": "How many winners (board seats). multiple_choice: the \"vote for up to N\" limit. ranked_choice/approval/cumulative: seats to fill."
},
"options": {
"type": "array",
"items": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"description": {
"type": "string"
}
}
}
]
},
"description": "Candidates or choices; required (at least 2) for every type except yes_no and open_text. A string, or {text, description} to include a candidate statement."
},
"required": {
"type": "boolean",
"description": "Whether a voter must answer. Defaults to true, except open_text."
},
"description": {
"type": "string",
"description": "Optional help text under the question."
},
"allow_write_in": {
"type": "boolean",
"description": "Let voters write in one candidate (single_choice, multiple_choice, approval, cumulative)."
},
"include_abstain": {
"type": "boolean",
"description": "Add an \"Abstain\" choice that counts toward turnout but never wins (yes_no, single_choice, multiple_choice, approval)."
}
}
},
"maxItems": 50,
"minItems": 1,
"description": "New questions, added after the last one, in this order."
},
"set": {
"type": "array",
"items": {
"type": "object",
"required": [
"text",
"type"
],
"properties": {
"text": {
"type": "string",
"description": "The question or race, e.g. \"Elect three directors\"."
},
"type": {
"enum": [
"single_choice",
"multiple_choice",
"yes_no",
"ranked_choice",
"approval",
"cumulative",
"open_text"
],
"type": "string",
"description": "single_choice: pick one. multiple_choice: pick up to `seats` (a multi-seat board race). yes_no: approve or reject a motion (Yes/No options are added automatically). ranked_choice: rank candidates; instant runoff for one seat, single transferable vote when seats > 1. approval: approve any number of candidates. cumulative: each voter spreads `seats` votes (minimum 2) across candidates, used where bylaws require cumulative voting. open_text: a written answer."
},
"seats": {
"type": "integer",
"minimum": 1,
"description": "How many winners (board seats). multiple_choice: the \"vote for up to N\" limit. ranked_choice/approval/cumulative: seats to fill."
},
"options": {
"type": "array",
"items": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"description": {
"type": "string"
}
}
}
]
},
"description": "Candidates or choices; required (at least 2) for every type except yes_no and open_text. A string, or {text, description} to include a candidate statement."
},
"required": {
"type": "boolean",
"description": "Whether a voter must answer. Defaults to true, except open_text."
},
"description": {
"type": "string",
"description": "Optional help text under the question."
},
"allow_write_in": {
"type": "boolean",
"description": "Let voters write in one candidate (single_choice, multiple_choice, approval, cumulative)."
},
"include_abstain": {
"type": "boolean",
"description": "Add an \"Abstain\" choice that counts toward turnout but never wins (yes_no, single_choice, multiple_choice, approval)."
}
}
},
"maxItems": 50,
"minItems": 1,
"description": "The whole ballot, in order, replacing every question on it."
},
"remove": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"required": [
"position"
],
"properties": {
"position": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "The question's place on the ballot as it stood before this change: 1 is the first."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "The question's id, from get_election."
}
},
"additionalProperties": false
}
]
},
"maxItems": 50,
"minItems": 1,
"description": "Questions to take off the ballot. A ballot keeps at least one question."
},
"update": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "The question's id, from get_election."
},
"text": {
"type": "string",
"description": "The question or race, e.g. \"Elect three directors\"."
},
"type": {
"enum": [
"single_choice",
"multiple_choice",
"yes_no",
"ranked_choice",
"approval",
"cumulative",
"open_text"
],
"type": "string",
"description": "single_choice: pick one. multiple_choice: pick up to `seats` (a multi-seat board race). yes_no: approve or reject a motion (Yes/No options are added automatically). ranked_choice: rank candidates; instant runoff for one seat, single transferable vote when seats > 1. approval: approve any number of candidates. cumulative: each voter spreads `seats` votes (minimum 2) across candidates, used where bylaws require cumulative voting. open_text: a written answer."
},
"seats": {
"type": "integer",
"minimum": 1,
"description": "How many winners (board seats). multiple_choice: the \"vote for up to N\" limit. ranked_choice/approval/cumulative: seats to fill."
},
"options": {
"type": "array",
"items": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"description": {
"type": "string"
}
}
}
]
},
"description": "Candidates or choices; required (at least 2) for every type except yes_no and open_text. A string, or {text, description} to include a candidate statement."
},
"position": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "The question's place on the ballot as it stood before this change: 1 is the first."
},
"required": {
"type": "boolean",
"description": "Whether a voter must answer. Defaults to true, except open_text."
},
"description": {
"type": "string",
"description": "Optional help text under the question."
},
"allow_write_in": {
"type": "boolean",
"description": "Let voters write in one candidate (single_choice, multiple_choice, approval, cumulative)."
},
"include_abstain": {
"type": "boolean",
"description": "Add an \"Abstain\" choice that counts toward turnout but never wins (yes_no, single_choice, multiple_choice, approval)."
}
},
"description": "Name the question by position or by id (not both), then give only the fields to change.",
"additionalProperties": false
},
"maxItems": 50,
"minItems": 1,
"description": "Questions to change, one entry each. Wording, help text, required, seats and write-ins change in place; a new type, new options or the Abstain choice rebuilds the question in the same place."
}
},
"description": "Changes to the ballot. set replaces every question and is sent on its own; otherwise remove, update and add run in that order. Positions count from 1, as the ballot stood before this change.",
"minProperties": 1,
"additionalProperties": false
},
"vote_type": {
"enum": [
"board_election",
"budget",
"amendment",
"resolution",
"custom"
],
"type": "string",
"description": "What the vote decides, for the state-law checks."
},
"description": {
"type": "string",
"description": "Instructions or background shown above the ballot. Plain text; an empty string removes it."
},
"verification": {
"enum": [
"email",
"email_or_sms"
],
"type": "string",
"description": "email: every voter confirms a code sent to their email (included free). email_or_sms: voters may also confirm by text message (paid elections only; elections of 25 voters or fewer are email-only)."
},
"secret_ballot": {
"type": "boolean",
"description": "Keep who voted for what private from the organizer. Defaults to true."
},
"community_type": {
"enum": [
"hoa",
"condo"
],
"type": "string",
"description": "hoa or condo, when the state rules differ between them."
},
"organization_name": {
"type": "string",
"description": "Association name shown to voters and used as the email sender name. Defaults to the account's organization."
}
},
"description": "Only the fields to change; every field means what it means in create_election_draft. At least one field.",
"minProperties": 1,
"additionalProperties": false
},
"election": {
"type": "string",
"description": "The draft's id or slug."
}
}
}| When voting opens, ISO 8601 with offset. Omit to open when published. |
| timezone* | string | IANA timezone of the association, e.g. America/Denver. Voters see times in it. |
| closes_at | string | When voting closes, ISO 8601 with offset, e.g. 2026-11-12T17:00:00-07:00. Must be in the future. Leave it out when nobody said: voting then closes at 5pm in `timezone` seven days from today, and the result says the exact time so it can be relayed and changed. |
| questions* | array | The ballot, in order. |
| vote_type | string | What the vote decides, for the state-law checks. |
| description | string | Optional instructions or background shown above the ballot. Plain text. |
| verification | string | email: every voter confirms a code sent to their email (included free). email_or_sms: voters may also confirm by text message (paid elections only; elections of 25 voters or fewer are email-only). |
| secret_ballot | boolean | Keep who voted for what private from the organizer. Defaults to true. |
| community_type | string | hoa or condo, when the state rules differ between them. |
| organization_name | string | Association name shown to voters and used as the email sender name. Defaults to the account's organization. |
{
"type": "object",
"required": [
"title",
"questions",
"timezone"
],
"properties": {
"state": {
"type": "string",
"description": "Two-letter US state code of the association (e.g. CA). Turns on that state's election-law checks before publishing."
},
"title": {
"type": "string",
"description": "Election title voters see, e.g. \"2026 Board of Directors Election\"."
},
"quorum": {
"type": "object",
"required": [
"type",
"threshold"
],
"properties": {
"type": {
"enum": [
"percentage",
"count"
],
"type": "string"
},
"threshold": {
"type": "integer",
"minimum": 1
}
},
"description": "Optional quorum: {type: \"percentage\" | \"count\", threshold}. E.g. {type: \"percentage\", threshold: 25} means a quarter of eligible voters must vote."
},
"voters": {
"type": "array",
"items": {
"type": "object",
"required": [
"email"
],
"properties": {
"name": {
"type": "string",
"description": "Owner or member name, shown on the roster."
},
"unit": {
"type": "string",
"description": "Unit, lot or address label, e.g. \"Unit 4B\"."
},
"email": {
"type": "string",
"format": "email"
}
}
},
"maxItems": 5000,
"description": "The eligible voters (the roster), one per owner/member. Email addresses only; people reached by text or mail are added by the organizer on the election page."
},
"results": {
"enum": [
"after_close",
"live",
"owner_only"
],
"type": "string",
"description": "after_close (default): voters see results once voting closes. live: running totals while voting is open. owner_only: only the organizer sees results."
},
"opens_at": {
"type": "string",
"format": "date-time",
"description": "When voting opens, ISO 8601 with offset. Omit to open when published."
},
"timezone": {
"type": "string",
"description": "IANA timezone of the association, e.g. America/Denver. Voters see times in it."
},
"closes_at": {
"type": "string",
"format": "date-time",
"description": "When voting closes, ISO 8601 with offset, e.g. 2026-11-12T17:00:00-07:00. Must be in the future. Leave it out when nobody said: voting then closes at 5pm in `timezone` seven days from today, and the result says the exact time so it can be relayed and changed."
},
"questions": {
"type": "array",
"items": {
"type": "object",
"required": [
"text",
"type"
],
"properties": {
"text": {
"type": "string",
"description": "The question or race, e.g. \"Elect three directors\"."
},
"type": {
"enum": [
"single_choice",
"multiple_choice",
"yes_no",
"ranked_choice",
"approval",
"cumulative",
"open_text"
],
"type": "string",
"description": "single_choice: pick one. multiple_choice: pick up to `seats` (a multi-seat board race). yes_no: approve or reject a motion (Yes/No options are added automatically). ranked_choice: rank candidates; instant runoff for one seat, single transferable vote when seats > 1. approval: approve any number of candidates. cumulative: each voter spreads `seats` votes (minimum 2) across candidates, used where bylaws require cumulative voting. open_text: a written answer."
},
"seats": {
"type": "integer",
"minimum": 1,
"description": "How many winners (board seats). multiple_choice: the \"vote for up to N\" limit. ranked_choice/approval/cumulative: seats to fill."
},
"options": {
"type": "array",
"items": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"description": {
"type": "string"
}
}
}
]
},
"description": "Candidates or choices; required (at least 2) for every type except yes_no and open_text. A string, or {text, description} to include a candidate statement."
},
"required": {
"type": "boolean",
"description": "Whether a voter must answer. Defaults to true, except open_text."
},
"description": {
"type": "string",
"description": "Optional help text under the question."
},
"allow_write_in": {
"type": "boolean",
"description": "Let voters write in one candidate (single_choice, multiple_choice, approval, cumulative)."
},
"include_abstain": {
"type": "boolean",
"description": "Add an \"Abstain\" choice that counts toward turnout but never wins (yes_no, single_choice, multiple_choice, approval)."
}
}
},
"minItems": 1,
"description": "The ballot, in order."
},
"vote_type": {
"enum": [
"board_election",
"budget",
"amendment",
"resolution",
"custom"
],
"type": "string",
"description": "What the vote decides, for the state-law checks."
},
"description": {
"type": "string",
"description": "Optional instructions or background shown above the ballot. Plain text."
},
"verification": {
"enum": [
"email",
"email_or_sms"
],
"type": "string",
"description": "email: every voter confirms a code sent to their email (included free). email_or_sms: voters may also confirm by text message (paid elections only; elections of 25 voters or fewer are email-only)."
},
"secret_ballot": {
"type": "boolean",
"description": "Keep who voted for what private from the organizer. Defaults to true."
},
"community_type": {
"enum": [
"hoa",
"condo"
],
"type": "string",
"description": "hoa or condo, when the state rules differ between them."
},
"organization_name": {
"type": "string",
"description": "Association name shown to voters and used as the email sender name. Defaults to the account's organization."
}
}
}| timezone* |
| string |
| IANA timezone of the association, e.g. America/Denver. Voters see times in it. |
| closes_at | string | When voting closes, ISO 8601 with offset, e.g. 2026-11-12T17:00:00-07:00. Must be in the future. Leave it out when nobody said: voting then closes at 5pm in `timezone` seven days from today, and the result says the exact time so it can be relayed and changed. |
| questions* | array | The ballot, in order. |
| vote_type | string | What the vote decides, for the state-law checks. |
| description | string | Optional instructions or background shown above the ballot. Plain text. |
| verification | string | email: every voter confirms a code sent to their email (included free). email_or_sms: voters may also confirm by text message (paid elections only; elections of 25 voters or fewer are email-only). |
| secret_ballot | boolean | Keep who voted for what private from the organizer. Defaults to true. |
| community_type | string | hoa or condo, when the state rules differ between them. |
| organization_name | string | Association name shown to voters and used as the email sender name. Defaults to the account's organization. |
{
"type": "object",
"required": [
"title",
"questions",
"timezone"
],
"properties": {
"state": {
"type": "string",
"description": "Two-letter US state code of the association (e.g. CA). Turns on that state's election-law checks before publishing."
},
"title": {
"type": "string",
"description": "Election title voters see, e.g. \"2026 Board of Directors Election\"."
},
"quorum": {
"type": "object",
"required": [
"type",
"threshold"
],
"properties": {
"type": {
"enum": [
"percentage",
"count"
],
"type": "string"
},
"threshold": {
"type": "integer",
"minimum": 1
}
},
"description": "Optional quorum: {type: \"percentage\" | \"count\", threshold}. E.g. {type: \"percentage\", threshold: 25} means a quarter of eligible voters must vote."
},
"voters": {
"type": "array",
"items": {
"type": "object",
"required": [
"email"
],
"properties": {
"name": {
"type": "string",
"description": "Owner or member name, shown on the roster."
},
"unit": {
"type": "string",
"description": "Unit, lot or address label, e.g. \"Unit 4B\"."
},
"email": {
"type": "string",
"format": "email"
}
}
},
"maxItems": 5000,
"description": "The eligible voters (the roster), one per owner/member. Email addresses only; people reached by text or mail are added by the organizer on the election page."
},
"results": {
"enum": [
"after_close",
"live",
"owner_only"
],
"type": "string",
"description": "after_close (default): voters see results once voting closes. live: running totals while voting is open. owner_only: only the organizer sees results."
},
"opens_at": {
"type": "string",
"format": "date-time",
"description": "When voting opens, ISO 8601 with offset. Omit to open when published."
},
"timezone": {
"type": "string",
"description": "IANA timezone of the association, e.g. America/Denver. Voters see times in it."
},
"closes_at": {
"type": "string",
"format": "date-time",
"description": "When voting closes, ISO 8601 with offset, e.g. 2026-11-12T17:00:00-07:00. Must be in the future. Leave it out when nobody said: voting then closes at 5pm in `timezone` seven days from today, and the result says the exact time so it can be relayed and changed."
},
"questions": {
"type": "array",
"items": {
"type": "object",
"required": [
"text",
"type"
],
"properties": {
"text": {
"type": "string",
"description": "The question or race, e.g. \"Elect three directors\"."
},
"type": {
"enum": [
"single_choice",
"multiple_choice",
"yes_no",
"ranked_choice",
"approval",
"cumulative",
"open_text"
],
"type": "string",
"description": "single_choice: pick one. multiple_choice: pick up to `seats` (a multi-seat board race). yes_no: approve or reject a motion (Yes/No options are added automatically). ranked_choice: rank candidates; instant runoff for one seat, single transferable vote when seats > 1. approval: approve any number of candidates. cumulative: each voter spreads `seats` votes (minimum 2) across candidates, used where bylaws require cumulative voting. open_text: a written answer."
},
"seats": {
"type": "integer",
"minimum": 1,
"description": "How many winners (board seats). multiple_choice: the \"vote for up to N\" limit. ranked_choice/approval/cumulative: seats to fill."
},
"options": {
"type": "array",
"items": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string"
},
"description": {
"type": "string"
}
}
}
]
},
"description": "Candidates or choices; required (at least 2) for every type except yes_no and open_text. A string, or {text, description} to include a candidate statement."
},
"required": {
"type": "boolean",
"description": "Whether a voter must answer. Defaults to true, except open_text."
},
"description": {
"type": "string",
"description": "Optional help text under the question."
},
"allow_write_in": {
"type": "boolean",
"description": "Let voters write in one candidate (single_choice, multiple_choice, approval, cumulative)."
},
"include_abstain": {
"type": "boolean",
"description": "Add an \"Abstain\" choice that counts toward turnout but never wins (yes_no, single_choice, multiple_choice, approval)."
}
}
},
"minItems": 1,
"description": "The ballot, in order."
},
"vote_type": {
"enum": [
"board_election",
"budget",
"amendment",
"resolution",
"custom"
],
"type": "string",
"description": "What the vote decides, for the state-law checks."
},
"description": {
"type": "string",
"description": "Optional instructions or background shown above the ballot. Plain text."
},
"verification": {
"enum": [
"email",
"email_or_sms"
],
"type": "string",
"description": "email: every voter confirms a code sent to their email (included free). email_or_sms: voters may also confirm by text message (paid elections only; elections of 25 voters or fewer are email-only)."
},
"secret_ballot": {
"type": "boolean",
"description": "Keep who voted for what private from the organizer. Defaults to true."
},
"community_type": {
"enum": [
"hoa",
"condo"
],
"type": "string",
"description": "hoa or condo, when the state rules differ between them."
},
"organization_name": {
"type": "string",
"description": "Association name shown to voters and used as the email sender name. Defaults to the account's organization."
}
}
}