Updated March 2026
Two steps: create the poll form, create a public dashboard. Sutrena's poll template does both in one API call.
Call POST /api/forms/from-template with templateId "poll". You get a form with a select field ("Your Vote") with four options, plus a dashboard with a pie chart, bar chart, and total votes metric. The response includes both the form URL and the dashboard URL.
Dashboards are private by default. To let anyone see results, update the dashboard to set isPublic: true. Now it's viewable at sutrena.com/d/{id} without login. It auto-refreshes every 30 seconds.
Want custom options? Create the form manually with your own select field, then build a dashboard with pie and bar charts grouped by the vote field. Add a text_block widget for the poll question.
Distribution: share the form URL directly, or embed it on your site. The hosted form URL works well for social media -- clean, mobile-friendly, quick to fill out.
Worried about ballot stuffing? Use uniqueBy on an email field to reject duplicate votes. Or set maxSubmissions to cap total votes.
AI agents can handle the whole thing. Create a poll, share the URL, read results later -- all within one conversation via MCP tools.
# Create a poll from template
curl -X POST https://sutrena.com/api/forms/from-template \
-H "Authorization: Bearer st_live_your_key" \
-H "Content-Type: application/json" \
-d '{ "templateId": "poll" }'
# Make the dashboard public for live results
curl -X PATCH https://sutrena.com/api/dashboards/DASHBOARD_ID \
-H "Authorization: Bearer st_live_your_key" \
-H "Content-Type: application/json" \
-d '{ "isPublic": true }'