Create slide

post

https://v1.zigpoll.com/slide

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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

pollId

string

The ID of the poll to add the slide to. Required unless dryRun is true.

type

string

enum

required

The slide type. Must be one of: question, checkbox, dropdown, image-choice, binary, legal-consent, inline-multiple-choice, star-rating, range, satisfaction, slider, short-answer, long-answer, email-capture, date, file-upload, country, rank, form, copy, thank-you, reward, action.

dryRun

boolean

If true, the slide object is built with all defaults and sanitization applied but is NOT saved to the database. Returns { data, idx } containing the full preview. Use POST /commit with the returned data to save it. When dryRun is true, pollId is not required.

title

string

The slide title. Defaults to "Slide N" if omitted.

subtitle

string

copy

string

Body copy (HTML supported).

placeholder

string

answers

array of objects

Answer options for choice-based slide types. The handle is auto-generated from the title.

answers

actions

array of objects

Action buttons (for action slide type).

actions

formInputs

array of objects

Form fields (for form slide type).

formInputs

settings

object

Slide settings. If omitted, defaults are applied (showTitle: true, showResults: false, randomizeAnswers: false, showResponses: false, optional: false, hidden: false, disableSentimentAnalysis: auto-set based on type).

logic

array of objects

Conditional logic rules for branching and actions.

logic

displayLogic

array of objects

Display logic rules controlling when this slide is shown.

displayLogic

leftLabel

string

Left label for range/satisfaction/star-rating types.

rightLabel

string

Right label for range/satisfaction/star-rating types.

multi

boolean

Allow multiple selections (for checkbox/inline-multiple-choice types).

rewardCode

string

rewardCodeType

string

enum

Allowed:

rewardBanner

string

customCTA

string

Custom call-to-action (string or object).

nextSlide

string

ID of the next slide, or "-1" to end the survey.

idx

integer

Position to insert the slide in the poll's slide list. Appended to the end if omitted.

Responses

404

Poll not found or you do not own the account it belongs to

200The created slide object

422Missing required field or invalid slide type