With our VAN integration, you can easily pass data from Blue Squad into VAN.


What VAN integration does

The following table shows how specific actions in Blue Squad will appear in your VAN instance once you have the integration setup:


Event in Blue SquadEffect in VAN
Blue Squad member supports your organization

My Voters

  • Update the corresponding voter record to indicate they have a favorable view of your campaign.


My Campaign

  • Create volunteer record in My Campaign (if not already present).
  • Tag volunteer record with activist code "Blue Squad Supporter".


Note: These will only occur if the Blue Squad member already exists in My Campaign or My Voters.

Blue Squad member (who supports your organization) syncs their phone contacts to their accountMy Voters
  • Look for each contact in My Voters and, if found, update the voter record with activist code "Known by Blue Squad".
Blue Squad member (who supports your organization) completes a relational voter registration mission for one of their contacts.My Voters
  • Update the corresponding voter record in My Voters with activist code "Known by Blue Squad".


How to set up VAN integration

Setting up your VAN integration requires a few steps.  Broadly speaking, they are:


In VAN

  1. Request your VAN API credentials.
  2. Create Blue Squad-specific activist codes.

In Blue Squad

  1. Provide your VAN API credentials and confirm they can authenticate with VAN.
  2. Confirm you've setup the activist codes correctly.
  3. Select the appropriate survey questions and responses for positive ID.

Read on for specifics on each of these steps:


Setting up VAN to work with Blue Squad

Request your VAN API credentials

Any sort of automated integration with VAN requires requesting an API key.  To do this:

  1. Go to the API Integrations page in VAN
  2. Click "Request an API Key"
  3. Click "Submit a Support Request".
  4. In your request, indicate that you want to integrate your Blue Squad account with your VAN instance.

Your request will be sent to your VFM (voter file manager).  In many cases, but not all, this is someone at your state party.  They will be responsible for issuing you the following:

  • A VAN App name
  • A VAN API key

Confirm or Create Blue Squad-specific activist codes in VAN

Check to see if you already have Blue Squad activist codes available in VAN.  You'll want to see if these codes exist:

  • "Known by Blue Squad" in My Voters
  • "Blue Squad Supporter" in My Campaign


These codes will already be available if your VAN admin has already set them up.


If they're not already available, you'll need to create specific activist codes in VAN under My Voters and My Campaign for your integration to work. 


Follow these steps to setup the appropriate activist codes in My Voters:

  1. Navigate to the Activist Codes page
  2. Add the following activist codes by clicking on "Add New Activist Code":


Long NameMedium NameShort Name
Known by Blue Squadbsq_knownkbb


Follow these steps to setup the appropriate activist codes in My Campaign:

  1. Navigate to the Activist Codes page
  2. Add the following activist codes by clicking on "Add New Activist Code":


Long NameMedium NameShort Name
Blue Squad Supporterbsq_suppbss


Note:

  • There are other fields present when creating activist codes. You can use your own discretion for how to fill them out.
  • It's possible you may not have the access permissions required to do this.  If so, you'll need to contact the person who does and ask them to add these codes.


Setting up Blue Squad to work with VAN

Thankfully, the Blue Squad part of this integration is much easier!  Once you've completed all the requirements in VAN, you just need to:

  1. Navigate to Settings > Organizations.  Scroll to the VAN Integration section.
  2. Enter your App Name and API Key under Step 1 and click "Verify".
  3. Assuming you've already set up the right activist codes in VAN, click "Verify" under Step 2.
  4. Select the appropriate survey question and response in Step 3.  Click "Confirm" when done.


That's all!  If any of the above steps fail, Blue Squad will let you know.