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 a user gets help with their voter registration application from TurboVote.
User Engagement Event-specific Fields
In addition to user profile fields, this event includes fields
-
applicationMethod noting the voter registration method pursued by the user
-
applicationStatus noting the status of the user’s voter registration application
-
applicationStatusSource noting how applicationStatus was determined
-
Values for applicationMethod and applicationStatus depend on a user’s state and its voter registration application options and regulations.
User applied to register to vote by mail
The following examples show what engagement-event specific fields would be returned in the following situations:
User used TurboVote to register to vote by mail and generate a National Mail Voter Registration Form:
"applicationMethod": "by-mail", // Voter registration application method "applicationStatus": "form-generated", // Voter registration application status "applicationStatusSource": "turbovote", // Source of voter registration application status.
User used TurboVote to register to vote by mail but indicated that they are not a citizen of the United States:
"applicationMethod": "by-mail", // Voter registration application method "applicationStatus": "ineligible", // Voter registration application status "applicationStatusSource": "user", // Source of voter registration application status.
User started to use TurboVote to register to vote by mail but did not complete the flow and no National Mail Voter Registration Form is generated
"applicationMethod": "by-mail", // Voter registration application method "applicationStatus": "form-generated", // Voter registration application status "applicationStatusSource": "turbovote", // Source of voter registration application status.
User applied to register to vote online
The following examples show what engagement-event specific fields would be returned in the following situations:
After getting help from TurboVote to register to vote online, user returned to TurboVote and answered “Yes” to the question “Did you finish the online voter registration process?“
"applicationMethod": "online", // Voter registration application method "applicationStatus": "complete", // Voter registration application status "applicationStatusSource": "user", // Source of voter registration application status
After getting help from TurboVote to register to vote online, user returned to TurboVote and answered “No” to the question “Did you finish the online voter registration process?“
"applicationMethod": "online", // Voter registration application method "applicationStatus": "incomplete", // Voter registration application status "applicationStatusSource": "user", // Source of voter registration application status
User started to use TurboVote to register to vote online but did not complete the flow and did not confirm that they completed their state’s online voter registration application.
"applicationMethod": "online", // Voter registration application method "applicationStatus": "initiated", // Voter registration application status "applicationStatusSource": "turbovote", // Source of voter registration application status
User attempted to apply to register to vote in a state where voter registration is administered at the local level
New Hampshire requires voters to contact their election official directly to register to vote.
A user living in New Hampshire attempted to use TurboVote to get help registering to vote but were advised to contact their local election official to register to vote.
"applicationMethod": "call-clerk", // Voter registration application method "applicationStatus": "not-required", // Voter registration application status "applicationStatusSource": "turbovote", // Source of voter registration application status
User attempted to apply to register to vote in North Dakota
North Dakota does not register voters.
A user living in North Dakota attempted to use TurboVote to get help registering to vote but were advised that North Dakota does not register voters:
"applicationMethod": "not-applicable", // Voter registration application method "applicationStatus": "not-required", // Voter registration application status "applicationStatusSource": "turbovote", // Source of voter registration application status
Example event
{
"specversion": "1.0"
"type": "org.turbovote.user.voter-registration-application-updated.v1",
"source": "/turbovote/webhook",
"time": "2024-04-01T17:06:46Z",
"data": {
// User that triggered the event, if known
"user": {
"id": "73c92af2-01a8-436d-a929-96009233db71",
"personalizationId": "ZScAnwr7RqKaIpvPFGpdPw",
"firstName": "John",
"middleName": "Doe",
"lastName": "Smith",
"preferredName": "Johnny",
"dateOfBirth": "1990-01-01",
"email": "john.doe@example.com",
"phone": "+1234567890",
"languagePreference": "en",
"metadata": {
"primary-key": "1234ABC"
},
"registeredAddress": {
"line1": "123 Main Street",
"line2": null,
"city": "Anytown",
"state": "CA",
"zip": "91234"
},
"referralCode": "ABCD1234",
"embedPlacement": "homepage",
"signedUpVia": "turbovote",
"partnerCommsOptIn": true, // optional Values include true false null
"createdAt": "2023-09-04T10:34:30Z",
"updatedAt": "2023-09-04T10:34:30Z"
},
// Event-specific fields
"applicationMethod": "online", // Voter registration application method. Values include online by-mail call-clerk not-applicable.
"applicationStatus": "initiated", // Voter registration application status. Values include initiated completed.
"applicationStatusSource": "turbovote", // Source of voter registration application status. Values include turbovote user.
}
}