Create Voter

Authorization

bearerAuth

AuthorizationBearer <token>

A key in the form pepvote_api_ followed by 32 hexadecimal characters.

In: header

Header Parameters

Idempotency-Keystring

Optional retry key. First successful response is stored for 24 hours.

Length: up to 255 characters

User-Agentstringrequired

Name and version of the calling integration. Required on every request.

Path Parameters

idOrCodestringrequired

Voting event ID or code.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

voterIdstring

Organizer-assigned identifier such as a member or student number. Unique within the event.

Length: up to 200 characters

namestring

Voter name.

Length: up to 200 characters

emailstring

Email used for voter key delivery and reminders.

Length: up to 320 characters

groupIdstring

Group the voter belongs to. Requires group mode.

weightnumber

Vote weight under weighted voting.

Minimum value: 0

statusenum<string>

Values:not_approved|pending|approved

Response Body

`application/json`

curl -X POST "https://example.com/voting-events/string/voters" \  -H "User-Agent: my-app/1.0" \  -H "Content-Type: application/json" \  -d '{}'

{
  "data": {
    "id": "string",
    "votingEventId": "string",
    "groupId": "string",
    "voterId": "string",
    "name": "string",
    "email": "string",
    "weight": 0,
    "status": "not_approved",
    "selfRegistered": true,
    "voted": true,
    "createdAt": 0
  }
}