To integrate your Deck account with VoteBuilder you'll have generate an API key, add that API key into Deck, and finally create a folder in VoteBuilder to save your lists into Deck. An API is a string of characters that allows Deck to communicate with your specific VoteBuilder account and save your lists in VoteBuilder securely.
This process, while slightly long, should be pretty easy. If you run into any issues setting up your integration, book a one on one support session with me here!
Generating Your API Key
In VoteBuilder, using the left panel search for "API Integrations."
From the API Integrations page of VoteBuilder, you'll see all your API keys, if you have them, and you'll be able to request a new API key.
On the upper right side of the integrations page, click the "Request an API Key" button.
In this flow, search for "Deck Tools" in the Integrations drop-down selector. It should auto-populate for you as you search. When you've selected Deck Tools, submit the request.
If you are not an admin of your VoteBuilder account, you may need your admin or state data director or voter file manager to approve it. API keys tend to be approved very quickly.
If you have any questions about API keys and VoteBuilder, reach out to your state party's voter file manager or data director.
Adding your Votebuilder API Key into Deck
To associate your VoteBuilder API key to your Deck account, go to your campaign's settings page (accessed through the settings gear in the upper right side of the screen).
Select "Integrations" on left side panel. The top of the Integrations page will be Credentials as seen below.
You will copy and paste your API key from VoteBuilder into the space given for the key in Deck and save it. When the key is saved, you'll be able to export your list from Deck to VoteBuilder!
Now when you go to the Targets page to select a universe, you'll be able to export your list directly into VoteBuilder!
Creating a Folder In Votebuilder to Save Your Deck Lists
After you generate an API key and associate it with your Deck account, there is still one final step to save lists in VoteBuilder. You will need to go to My Folders to create a folder for the Deck exports to get saved into. Again, you can search for it in the left side menu.
In My Folders, create a new folder and name it whatever you see fit for your Deck exports.
The most important thing to remember is to you need to allow the API to save into the folder. This setting is what allows Deck to see that this folder exists. It is important that it gets checked when you’re going to create this folder. When the folder is created, this is what the folder looks like and it is ready to accept exports now.
Then you need to add the Deck API as a user. After you save the folder, you can add and remove users with access. In "User Access" dialogue box below, select the Deck API as a user and click add to allow Deck to make edits to the folder. Save the folder and you should be set to go!
I don't see the "Allow the API to save into this folder" button.
Make sure that the "Allow other users to save into this folder" button is selected. If that button is selected and you still do not see the "Allow the API to save into this folder" button, you do not have the necessary VoteBuilder permissions. Have your campaign admin try and create the folder.
If you still are unable to see the "Allow the API to save into this folder" button even for your VAN admin contact firstname.lastname@example.org and your state party VAN admin.
I have selected the "Allow the API to save into this folder" button but exports still aren't working.
Make sure that the Deck API user is a user that is allowed to save into the folder.