How do I create a live poll with real-time results?

Set publicResults: true when creating the form. This enables a public endpoint that returns vote counts by option. A pie chart dashboard is created alongside. Anyone with the link can see results.

Can I prevent people from voting twice?

Set uniqueBy: ['email']. Duplicate votes get a 409 response. This works at the API level. It does not prevent someone from using a different email address.

Can I close the poll after a deadline?

Set closesAt to an ISO datetime. After that time the form returns 410 and stops accepting votes. Results stay visible.

Sutrena is the web runtime for AI agents. Three primitives — pages, forms, dashboards — any agent creates with one API call. Framework-agnostic. Works from Claude Code, Cursor, LangGraph, CrewAI, or any HTTP client.

How do I get started with Sutrena?

POST /api/trial to get an instant API key — no signup required. Then POST /api/forms with a template ID to create a hosted form with a matching dashboard in one call.

Does Sutrena support AI agents?

Yes. Sutrena includes 48 MCP tools for Claude Code, Cursor, and any MCP client. It also provides a full REST API, OpenAPI spec, llms.txt, and agent-optimized error messages.

How much does Sutrena cost?

Free: 10 projects, 500 submissions/form, 50MB storage. Builder: $9/month for 50 projects, 5,000 submissions/form, CSV export, upsert API. Pro: $29/month for 200 projects, unlimited submissions. Scale: $79/month for unlimited everything.

Can I embed Sutrena forms on my website?

Yes. Use the 2-line embed snippet or build a custom HTML form that POSTs JSON to the submit URL. Works with Framer, Webflow, WordPress, and any HTML site.

What happens to my data after the trial expires?

Unclaimed trial data is deleted after 24 hours. Visit the claimUrl to sign in with GitHub or Google and keep your data permanently. Or upgrade to Builder, Pro, or Scale.

Does Sutrena support webhooks?

Yes. Register webhook URLs to receive form submission events with HMAC-SHA256 signatures. Supports Slack and Discord payload templates, field mapping, and automatic retry with failure tracking.

Live polls with real-time results

A form with options. A pie chart that updates. A deadline.

You want your community or team to vote on something. “Which feature should we build next?” You need live results so people can see where things stand. And you probably want one vote per person.

How an agent handles this: Your agent creates a poll via API (voting options, uniqueBy: email, closesAt deadline). Shares poll URL with community. People submit votes. Dashboard shows live results as pie chart. When deadline hits, poll auto-closes. Agent processes final results (shares winner, triggers action on top choice).

Where are you running polls now?

Without Sutrena

✗Data locked in Twitter or Slack. Hard to reference later.
✗No public results page to embed or share
✗People vote multiple times
✗Results disappear when the thread gets archived
✗No API to read results programmatically

With Sutrena

✓Public results endpoint returns live vote counts as JSON
✓Dashboard shows a pie chart, refreshes every 30 seconds
✓uniqueBy prevents duplicate votes (by email, at least)
✓closesAt deadline stops the poll automatically
✓Export CSV or read via API anytime

One API call

curl -X POST https://sutrena.com/api/forms \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "What should we build next?",
    "fields": [
      {"name": "email", "label": "Email", "type": "email", "required": true},
      {"name": "vote", "label": "Your vote", "type": "select",
       "options": ["Dark mode", "Mobile app", "API v2", "Integrations"],
       "required": true}
    ],
    "uniqueBy": ["email"],
    "publicResults": true,
    "closesAt": "2026-03-15T23:59:00Z",
    "createDashboard": true
  }'

What this costs

A single poll is one form. Builder ($9/month) covers it — 50 projects, 5,000 votes per form. If you expect more than 5,000 votes, Pro is $29/month for unlimited submissions. No per-response fee either way.

View full pricing

What is Sutrena?

Sutrena is the web runtime for AI agents. Three primitives — pages, forms, and dashboards — accessible through one API. Your agent creates web artifacts, humans interact with them, and your agent gets the data back. Framework-agnostic. Works from any MCP client or HTTP client.

Get started in two API calls

1. Get a trial key (no auth, no signup)

curl -X POST https://sutrena.com/api/trial

2. Create a form + dashboard from a template

curl -X POST https://sutrena.com/api/forms \
  -H "Authorization: Bearer st_trial_xxx" \
  -H "Content-Type: application/json" \
  -d '{"templateId": "waitlist", "createDashboard": true}'

/llms.txt /api/schema /llms-full.txt /.well-known/mcp.json

Need to decide something?

Get a trial key. Your agent creates the poll. Share the link.

Start building Full reference