Zigpoll

Cancels a currently running synthetic research job. Already-generated responses are kept.

Creates a clean copy of the poll (with slides but without response data). Useful for creating a fresh copy after synthetic research to run a new round.

Generate a unique, trackable survey link for a given poll. Each call creates a new activity record and returns a unique URL that can be distributed to a respondent. Optionally attach metadata (key-value pairs) to the activity for tracking purposes. Enforces plan-based monthly survey link limits.

Get an account object for an an accountId that you provide.

Get all account objects for the authenticated user.

Get email objects for a particular slide, poll, or account that you provide.

Get automated ai insight objects for a particular slide, poll, or account that you provide.

Get the authenticated user object.

Get participant objects for a particular slide, poll, or account that you provide.

Get a specific poll object for a pollId that you provide.

Get all polls for a particular accountId that you provide.

Get response objects for a particular slide, poll, or account that you provide.

Get a specific slide object based on the slideId that you provide. For most slide types the `answers` array holds each answer option with its `votes` count. For `matrix` slides, `answers` lists the shared answer columns (the rating scale) and an additional `rows` array is returned — one entry per question (row), each with its own `answers` array giving the `votes` for every column. The `rows[].answers[].votes` values are the response counts for each option in the matrix.

Get all slides for a particular pollId that you provide.

Returns the current status and progress of synthetic research on a poll.

Save a previously staged (dry run) poll or slide object to the database. Use this after reviewing the preview returned by POST /poll or POST /slide with `dryRun: true`. The object is inserted as-is — no re-processing or default merging is applied.

Create a new poll (survey) under an account you own. The poll is created with `isVisible: false` and no slides. You can also use `/survey` as an alias.

Update an existing poll (survey). Only the fields you include in the request body will be changed — all other fields remain untouched. System-managed fields (counts, timestamps, slides list) are ignored if sent. You can also use `/survey/update` as an alias.

Create a new slide (question) within an existing poll. The poll must belong to an account you own. The `handle` field is automatically generated from the title. If `title` is omitted it defaults to "Slide N". When `dryRun` is true, `pollId` is optional — the slide object is built with defaults and returned without any database lookups.

Update an existing slide (question). Only the fields you include in the request body will be changed — all other fields remain untouched. System-managed fields (counts, insights, timestamps) are ignored if sent. The `handle` field is automatically generated from the title. Set a field to -1 to remove it from the slide.

Send an email survey invitation to one or more recipients. Accepts a single email string or an array of email strings. Enforces plan-based email limits, spam detection, and bulk-send validation.

Send an SMS survey invitation to one or more phone numbers. Accepts a single phone number string or an array of phone number strings. Phone numbers are automatically normalized and deduplicated. Enforces plan-based SMS limits, spam detection, and bulk-send validation.

Starts AI-powered synthetic research on a poll, generating realistic survey responses using demographic personas and GPT-4. The generation runs asynchronously — this endpoint returns immediately. Use GET /research/status to monitor progress.