Event: User Voter Election Action Taken

To learn more or to gain access to TurboVote Webhook events, contact your TurboVote Partner Manager, drop us a line or grab a time to meet.

This user engagement event is emitted when an existing TurboVote user visits a personalized election guide (generally the link in an election reminder) and takes a key action to make a plan to vote.

User Engagement Event-specific Fields

In addition to user profile fields included in every engagement event, this event includes details about the

Election the user took action on, including the election’s date, description, Open Civic Data Identifier and district type.
Action Taken by the user on the page, including its
- description, url and source as well as the referrer type and medium of the action taken
- description, url and source of the page where the action was taken

Visit the Latest Election Action Taken section of the TurboVote Data Dictionary for details on the fields share in this event.

Example Event Payloads

The following sections provide a sample event payload a couple of example scenarios:

User Visits Personalized Election Guide from Partner Communication

User tapped the hyperlink in an Upcoming Election Reminder email e.g. https://example.turbovote.org/elections/ca/2024-11-05?user=Zh_gBG5LQQCwbP_7b7AH3Q

"time":"2024-09-30T20:09:33.143Z",
"type":"org.turbovote.user.voter-election-action-taken.v1",
"source":"/turbovote/webhook",
"specversion":"1.0",
"data" {
  "user" :{ ... },
  "election": {
    "date":"2024-11-05",
    "description":"California General Election",
    "ocdId":"ocd-division/country:us/state:ca",
    "type":"state"
  },
  "action":{
    "type":"visited-guide",
    "description":"Nov 5 California General Election TurboVote Election Guide",
    "url":"https://example.turbovote.org/elections/ca/2024-11-05",
    "source":"user",
    "page": {
      "type": "election",
      "description": "Nov 5 California General Election TurboVote Election Guide",
      "url": "https://example.turbovote.org/elections/ca/2024-11-05"
    "referrer":{
      "type":"personalizedLink",
      "medium":"link"
    }
   }
  }
}

User Visits Personalized Election Guide from TurboVote Upcoming Election Reminder Email

User tapped the hyperlink in an Upcoming Election Reminder email e.g. https://example.turbovote.org/elections/ca/2024-11-05?user=Zh_gBG5LQQCwbP_7b7AH3Q&m=e&a=u

"time":"2024-09-30T20:09:33.143Z",
"type":"org.turbovote.user.voter-election-action-taken.v1",
"source":"/turbovote/webhook",
"specversion":"1.0",
"data" {
  "user" :{ ... },
  "election": {
    "date":"2024-11-05",
    "description":"California General Election",
    "ocdId":"ocd-division/country:us/state:ca",
    "type":"state"
  },
  "action":{
    "type":"visited-guide",
    "description":"Nov 5 California General Election TurboVote Election Guide",
    "url":"https://example.turbovote.org/elections/ca/2024-11-05",
    "source":"user",
    "page": {
      "type": "election",
      "description": "Nov 5 California General Election TurboVote Election Guide",
      "url": "https://example.turbovote.org/elections/ca/2024-11-05"
    "referrer":{
      "type":"upcoming-election-reminder",
      "medium":"email"
    }
   }
  }
}

User Visits Personalized Election Guide from TurboVote Upcoming Election Reminder Email and Requests Mail Ballot

User tapped the hyperlink in an Upcoming Election Reminder email e.g. https://example.turbovote.org/elections/ny/2024-11-05?user=Zh_gBG5LQQCwbP_7b7AH3Q&m=e&a=u
User tapped "Request absentee ballot"

"time":"2024-09-30T20:09:33.143Z",
"type":"org.turbovote.user.voter-election-action-taken.v1",
"source":"/turbovote/webhook",
"specversion":"1.0",
"data" {
  "user" :{ ... },
  "election": {
    "date":"2024-11-05",
    "description":"New York General Election",
    "ocdId":"ocd-division/country:us/state:ny",
    "type":"state"
  },
  "action":{
    "type":"requested-ballot",
    "description":"Request Early Mail Ballot by Oct 26",
    "url":"https://elections.ny.gov/request-ballot",
    "source":"user",
    "page": {
      "type": "election",
      "description": "Nov 5 California General Election TurboVote Election Guide",
      "url": "https://example.turbovote.org/elections/ca/2024-11-05"
    "referrer":{
      "type":"upcoming-election-reminder",
      "medium":"email"
    }
   }
  }
}

User Visits Personalized Election Guide from TurboVote Upcoming Election Reminder Email and navigates to view Ballot Measure Guide

User tapped the hyperlink in an Upcoming Election Reminder email e.g. https://example.turbovote.org/elections/ny/2024-11-05?user=Zh_gBG5LQQCwbP_7b7AH3Q&m=e&a=u
User tapped "View ballot"
User tapped "Proposition 2" ballot measure: https://example.turbovote.org/ballot-info/ocd-division%2Fcountry%3Aus%2Fstate%3Aca/2024-11-05?user=Zh_gBG5LQQCwbP_7b7AH3Q
https://example.turbovote.org/ballot-info/ocd-division%2Fcountry%3Aus%2Fstate%3Aca/2024-11-05/ballot/measure/bm_927e6218ff22ebc6b36640f7337bdeb0c80d7684?user=Zh_gBG5LQQCwbP_7b7AH3Q

"time":"2024-09-30T20:09:33.143Z",
"type":"org.turbovote.user.voter-election-action-taken.v1",
"source":"/turbovote/webhook",
"specversion":"1.0",
"data" {
  "user" :{ ... },
  "election": {
    "date":"2024-11-05",
    "description":"New York General Election",
    "ocdId":"ocd-division/country:us/state:ny",
    "type":"state"
  },
  "action":{
    "type":"viewed-ballot-measure",
    "description":"Proposition 2",
    "url":"https://example.turbovote.org/ballot-info/ocd-division%2Fcountry%3Aus%2Fstate%3Aca/2024-11-05/ballot/measure/bm_927e6218ff22ebc6b36640f7337bdeb0c80d7684",
    "source":"user",
    "page": {
      "type": "ballot-measure",
      "description": "Nov 5 California General Election Ballot Guide ",
      "url": "https://example.turbovote.org/ballot-info/ocd-division%2Fcountry%3Aus%2Fstate%3Aca/2024-11-05"
    "referrer":{
      "type":"upcoming-election-reminder",
      "medium":"email"
    }
   }
  }
}

Search