< back to index

HTTP request

post https://api.wevoteusa.org/apis/v1/voterContactListSave (Jump to "Try It Now")

Required Parameters

Parameter name Value Description
api_key string (from post, cookie, or get (in that order)) The unique key provided to any organization using the WeVoteServer APIs
voter_device_id string An 88 character unique identifier linked to a voter record on the server.
contacts string A json structure of Google contacts, arrives as a string

Response

{
  "success": boolean,
  "status": string,
  "we_vote_id_for_google_contacts" string, 
  "contacts_stored": integer, 
}

Response Status Codes

Code Description
VALID_VOTER_DEVICE_ID_MISSING A valid voter_device_id parameter was not included. Cannot proceed.
VOTER_NOT_FOUND_FROM_VOTER_DEVICE_ID No voter could be found from the voter_device_id

Try It Now: API Variables

Receive a voter's Google contacts for saving.
Example JSON string to add one contact:
  [{"display_name": "George Washington","family_name": "Washington","given_name": "George","email": "george@whitehouse.com","update_time": "2014-03-20T16:36:33.176Z","type": "OTHER_CONTACT"}]

Parameter name Value  
voter_device_id:
contacts:

(opens in new window)