Creates a new survey in draft status. The survey must be published separately using the publish endpoint.
Each survey contains one or more questions, each with a type (head_to_head, ranked, open_ended, etc.) and optional answer options. You can also specify targeting traits, reporting breakdowns, country, and sample size.
Documentation Index
Fetch the complete documentation index at: https://www.pickfu.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
OAuth2 access token obtained via the authorization flow. Include in the Authorization header as: Bearer {access_token}
List of questions for the survey
1Survey name (1-255 characters, trimmed)
1 - 255Project GUID (string) or numeric ID to associate with the survey, or null to leave unassigned. Mutually exclusive with projects.
Project GUIDs (or numeric IDs) to associate the survey with. Mutually exclusive with projectId.
50Tags to attach. Each item has either id (existing tag) or name (find-or-create).
10Demographic targeting traits
Reporting breakdown traits
Two-letter country code (e.g. US)
Number of respondents (e.g. "15", "30", "50", "75", "100", "200", "300", "500")
Original intent of the survey as interpreted by AI (max 255 characters)
255Whether to create this survey as a daily mini-poll