When to use URL parameters
URL parameters are ideal for developers and technical users who want to:
Pre-populate poll fields in their applications
Create automated poll generation workflows
Integrate PickFu directly into existing tools and platforms
Build custom interfaces that feed into PickFu's poll builder
Prerequisites: Basic understanding of URL encoding and query parameters
Understanding the endpoint
PickFu's poll builder endpoint:
https://app.pickfu.com/ask/survey
Use this for both single-question polls and multi-question surveys. URL parameters apply to the first question in the survey.
Important: All parameter values must be URL-encoded, and multiple parameters are separated with &
.
Core poll parameters
Essential parameters
Parameter | Type | Purpose | Allowed Values |
| string | The poll question text | URL-encoded text |
| integer | Number of answer choices | 1-12 |
| integer | Number of responses to collect | 15, 50, 100, 200, 500 |
| enum | Type of poll to create | See poll types below |
Poll type options
Poll Type | Value | Description |
Head-to-Head |
| Compare two options directly |
Ranked |
| Rank multiple options in order |
Open-Ended |
| Collect written feedback |
Click-Test |
| Track where users click on images |
Example basic poll URL
https://app.pickfu.com/ask/survey?question=Which%20logo%20do%20you%20prefer%3F&num_options=2&num_responses=50&poll_type=TurkJobPoll
Setting up poll options
Options use a numbered hash format starting from index 0:
Text-based options
options[0][value]=Option%20A options[1][value]=Option%20B
Image-based options
options[0][media_url]=https://example.com/image-a.jpg options[1][media_url]=https://example.com/image-b.jpg
Mixed options (text + image)
options[0][value]=Logo%20Design%20A options[0][media_url]=https://example.com/logo-a.png options[1][value]=Logo%20Design%20B options[1][media_url]=https://example.com/logo-b.png
Advanced poll parameters
Rating polls
For star rating polls, add:
score_max=5
This sets the maximum star rating (default is 5).
Click-test polls
For click-test polls, specify:
num_clicks=3
This sets how many clicks respondents can make on your image.
Complete example URL
Here's a full example for a logo comparison poll:
https://app.pickfu.com/ask/survey?question=Which%20logo%20better%20represents%20our%20brand%3F&num_options=2&num_responses=100&poll_type=TurkJobPoll&options[0][value]=Logo%20A&options[0][media_url]=https://example.com/logo-a.png&options[1][value]=Logo%20B&options[1][media_url]=https://example.com/logo-b.png
Troubleshooting common issues
Why aren't my parameters working?
Check URL encoding: Special characters must be properly encoded (spaces as
%20
, question marks as%3F
)Verify parameter names: They're case-sensitive and must match exactly
Test with simple values first: Start with basic text before adding complex media URLs
How do I handle special characters?
Use proper URL encoding for all parameter values:
Space:
%20
Question mark:
%3F
Ampersand:
%26
Plus sign:
%2B
What if my image URLs don't work?
Ensure images are publicly accessible
Use HTTPS URLs when possible
Verify image formats are supported (JPG, PNG, GIF)
Check that URLs don't require authentication
Can I test my URLs before going live?
Yes! Click your parameterized URL to see how it populates the poll builder. You can review all settings before creating the poll.
Advanced integration options
PickFu API
For more robust integrations, consider using PickFu's API instead of URL parameters. The API offers:
Better error handling and validation
Programmatic poll management
Webhook support for results
Response data in structured formats
Poll status monitoring
Zapier Integration
PickFu's Zapier integration provides a no-code solution for automating poll creation:
Trigger polls from other apps: Create polls automatically when certain events happen in your workflow
Connect to 6,000+ apps: Integrate with tools like Google Sheets, Slack, Airtable, and more
Automate results processing: Send poll results to spreadsheets, notifications, or other systems
Multi-step workflows: Chain poll creation with other actions in complex automation sequences
Free to use: Linking your PickFu and Zapier accounts is completely free
Contact support to learn about API access or visit our Zapier integration page for setup assistance and templates.