Pepvote API
Quick start
Make your first Pepvote API request with curl.
Set your API key in a shell variable. Run this from a trusted server or local terminal. Do not put the key in browser code.
export PEPVOTE_API_KEY="pepvote_api_0123456789abcdef0123456789abcdef"
export PEPVOTE_API_URL="https://api.pepvote.com"Check the API
The health check does not need a key.
curl "$PEPVOTE_API_URL/health"{ "status": "ok", "time": 1777003200000 }Check the key owner
curl "$PEPVOTE_API_URL/me" \
-H "Authorization: Bearer $PEPVOTE_API_KEY"{
"data": {
"user": { "id": "user_01", "name": "Jordan Lee", "email": "jordan@example.com" },
"apiKey": { "id": "key_01", "name": "CRM sync", "scopes": ["read", "write"] }
}
}List voting events
curl "$PEPVOTE_API_URL/voting-events?limit=50" \
-H "Authorization: Bearer $PEPVOTE_API_KEY"Create a voter
curl -X POST "$PEPVOTE_API_URL/voting-events/BOARD26/voters" \
-H "Authorization: Bearer $PEPVOTE_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: add-amina-bello-001" \
-d '{"voterId":"M-1042","name":"Amina Bello","email":"amina@example.com","status":"approved"}'Read authentication, pagination and errors, and idempotency before you connect a production workflow.
Was this helpful?
Last updated September 5, 2026