Updated March 2026
Create the poll form with the compound tool sutrena_collect (POST /api/pipeline) and optional notifications.
Call POST /api/pipeline with your poll fields and optional webhook notifications. You get a form with a select field. The response includes the form URL and submission endpoint.
Want custom options? Create the form manually with your own select field. Read results via GET /api/forms/{id}/submissions or set up a webhook for real-time notifications.
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 form
curl -X POST https://sutrena.com/api/pipeline \
-H "Authorization: Bearer st_live_your_key" \
-H "Content-Type: application/json" \
-d '{ "name": "Quick Poll", "fields": [{"name": "vote", "label": "Your Vote", "type": "select", "options": ["Option A", "Option B", "Option C", "Option D"], "required": true}] }'
# Read poll results
curl https://sutrena.com/api/forms/FORM_ID/submissions \
-H "Authorization: Bearer st_live_your_key"