GetThru <> VAN Integration


GetThru's VAN Integration is a two-way sync that lets you import lists from VAN and export contact data and campaign results to VAN. The first step in setting up your integration involves obtaining an API key from your VAN account. 


This guide will walk you through obtaining an API key from VAN. For some general information about VAN and and overview of VAN guides, check out our guide: GetThru VAN Integration Overview.


TABLE OF CONTENTS


Request a VAN API Key

To get started, you will need a VAN API key to link your GetThru and VAN accounts. VAN has a helpful guide, which you can access if you're logged in: How to: Request and approve API keys.


To generate the key, find the sidebar and click API Integrations. Then click on Request an API Key:

You must be an administrative user configured in the Support Request System in order to set up and generate keys. If you cannot find this page, you will need to contact your VAN administrator or the person who created your VAN account to request this information.


After you click Request an API key, you'll set the Integration and who the Request will be sent to.

Screenshot of the "Request an API Key" modal to submit a request. "RelayTXT" has been selected from the first drop down.

For Integration, select one of following:

  • ThruText
  • RelayTxt
  • ThruTalk
  • RelayDial

Select the one that corresponds with the product you want to integrate with. You'll also be asked to select the the administrator to which the request will be sent. Once you Submit Request, a VAN support ticket will be opened where your VAN administrator can authorize the request.


Once your key request has been authorized, the integration or key request will appear in the API Keys section. Click Generate API Key to securely generate a key:

Screenshot of a populate API integrations "request a key" page.

Once a key has been generated, it will will be listed under the API Keys section but you will now see an action menu (...) with an option for regenerating. 

EveryAction/NGP8 users may require two keys - one for MyVoters and one for their EveryAction/NGP8 account. Please inquire with your VAN/EveryAction admins for your committee's API key needs.


If you regenerate your API key, it will break any existing integration with your GetThru account.


Setting Permissions in your Folder

The next step to setting up your integration is configuring permissions in your VAN folder. Before you can pull lists from VAN to GetThru, you must grant GetThru the permissions to access your lists in your VAN folder. VAN has a helpful guide, which you can access if you're logged in: How do I add and manage Folders?.


From the left sidebar, click Main Menu, then click View My Folders. Or, search for My Folders in the search bar.

From here, you can click Add New Folder.

Next, name your folder and enter a description. To give permissions for GetThru to access this folder, enable the following settings:

The second checkmark may appear after checking the first. It won't be available for all committees, so you can proceed with the next steps.


After clicking Save, you'll see a menu appear to provide User Access. On this page, you must select the api user and then click Add.

Users may include

  • api, relaytxt
  • api, relaydial
  • api, getthru
  • api, thrutext
  • api, thrutalk

Your folder is now ready to sync with GetThru!


Next Up

Now that you have your API key, you can enter it in GetThru. Read this guide next for a step-by-step explanation: VAN Integration Setup - Step 2: Entering the API Key in GetThru.