Skip to main content

​
Overview

PollUnit lets you create and manage polls, surveys, and voting pages programmatically. This documentation covers everything you need to get started with the API.

API Reference

Explore every endpoint, request, and response schema.

​
Authentication

Every request must include a personal API token as a Bearer token in the Authorization header. You have two tokens available:

Private token

Full access — create, update, and delete polls. Keep this secret.

Public token

Read-only — safe to embed in client-side code.
Find both tokens under My Account → API in your PollUnit dashboard.

​
Organizations

Every endpoint accepts an optional organization_id query parameter. It takes the public_id of an organization you belong to and runs the request in that organization’s context — new polls are owned by the organization and listings are scoped to it. Omit organization_id (or leave it blank) to act as your personal account. Passing the public_id of an organization you don’t have access to returns 401 Unauthorized.

​
Next steps

1

Get your API token

Log in to PollUnit and copy your private or public token from Account settings.
2

Make a request

Try listing your polls with a GET request to /api/v1/polls.
3

Explore the reference

Browse the full API Reference for all available endpoints.