Quick start

1. Make an API key

Sign in to Pairpoll, open API keys, create a key and copy it. The key is shown once.

Keep it private. Send it as Authorization: Bearer <key>.

2. Pick the shortest path

For local files, use the CLI. It is not on npm yet, so first set it up from the repository as shown in the CLI reference. Then:

export PAIRPOLL_API_URL=https://pairpoll.com
export PAIRPOLL_API_KEY=ppk_your_key
pairpoll create ./images --question "Which image is strongest?" --top 3 --open

The command prints the poll ID and voter share link.

For an HTTP integration, create a draft with the REST API:

curl "$PAIRPOLL_API_URL/api/v1/polls" \
  -H "Authorization: Bearer $PAIRPOLL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"image","question":"Which image is strongest?","topSize":3}'

Then upload 2 to 16 files and open the poll. See the API reference.

For Claude Code, Codex or Cursor, connect the MCP server. It creates a draft and gives you a browser page for uploading files.

Local development

Point the CLI at the local Worker:

export PAIRPOLL_API_URL=http://localhost:4321
pairpoll --json list

The REST base is http://localhost:4321/api/v1. The MCP endpoint is http://localhost:4321/mcp.

This page as plain Markdown: /docs/quick-start.md

Pairpoll uses Google Analytics cookies to see which pages people visit, only if you accept. Details are on the privacy page.