< back to index

HTTP request

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

Required Parameters

Parameter name Value Description
voter_device_id string An 88 character unique identifier linked to a voter record on the server
return_url string The URL where the browser should be redirected once authenticated. Usually https://wevote.me/settings/account
api_key string (from post, cookie, or get (in that order)) The unique key provided to any organization using the WeVoteServer APIs


  "status": string,
  "success": boolean,
  "voter_device_id": string (88 characters long),
  "twitter_redirect_url": string, (Where twitter wants We Vote to redirect the browser, with variables)
  "voter_info_retrieved": boolean, (if handled without redirect, was voter info retrieved from Twitter?)
  "switch_accounts": boolean, (Was there an existing account for this Twitter account? If true, a new voter_device_id is returned that links to this other We Vote account.)

Response Status Codes

Code Description
VALID_VOTER_DEVICE_ID_MISSING Cannot proceed. A valid voter_device_id parameter was not included.
VALID_VOTER_ID_MISSING Cannot proceed. A valid voter_id was not found.

Try It Now: API Variables

Flow chart showing entire process here: https://docs.google.com/drawings/d/1WdVFsPZl3aLM9wxGuPTW3veqP-5EmZKv36KWjTz5pbU/edit

Parameter name Value  

(opens in new window)