Simply Voting now supports webhooks, giving organizations a new way to connect election activity with their own systems. With webhooks enabled, Simply Voting can automatically notify an organization’s system when an elector votes.
What information can a webhook send?
Each time an elector votes, Simply Voting creates a vote event. Vote events are generated across all voting channels, including the voting website, kiosk voting, telephone voting, and manual vote entry.
Each event can include:
- the Election ID;
- the Elector ID;
- the time the vote was cast; and
- additional elector information configured for the account, where applicable.
Importantly, ballot selections are never included. A webhook can tell another system that an elector voted, but not how that elector voted.
This maintains the separation between participation information and ballot choices while allowing organizations to automate processes that depend on knowing whether someone has participated.
How could organizations use webhooks?
Webhooks are most useful when another system needs to know that an elector has participated without waiting for someone to export and import election data manually.
For example, an organization could use vote events to:
- update a member, student, employee, or other voter record after that person votes;
- synchronize participation information with a CRM, membership database, or internal system;
- trigger an internal workflow once participation is recorded; or
- distinguish activity across several elections running at the same time using the Election ID included with each event.
Because the event also includes the time the vote was cast, an organization can retain that timing information in its own system when it is relevant to its workflow.
The webhook does not replace Simply Voting’s election records or reports. It provides a way for another system to react to participation as the election is underway.
How do webhooks work?
Rather than sending each vote event individually, Simply Voting groups vote events from the previous minute and sends them to the organization’s configured endpoint in a single request. This provides regular participation updates without requiring a separate request for every ballot cast.
Setting up the integration requires an HTTPS endpoint capable of receiving the webhook requests. Each request is signed, and the organization’s endpoint verifies it using a signing secret provided in the Election Manager.
Simply Voting also provides a built-in test when the webhook URL is configured or changed. The configuration is only saved once the test request has been successfully received.
Webhooks are available on all Simply Voting accounts and can be configured by a super user under Settings → Integrations.
Connect election participation to your existing systems
Webhooks give organizations with the appropriate technical resources a direct way to use election participation information in their existing systems without exposing how anyone voted.
For setup requirements, delivery details, and technical documentation, see our webhooks and integrations documentation.
Want to connect Simply Voting with your CRM, membership database, or another internal system? Contact us to discuss your election and integration requirements.