Skip to main content

How to build PickFu surveys with URL parameters

Build custom PickFu polls and surveys programmatically using URL parameters for seamless workflow integration.

Updated this week

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

question

string

The poll question text

URL-encoded text

num_options

integer

Number of answer choices

1-12

num_responses

integer

Number of responses to collect

15, 50, 100, 200, 500

poll_type

enum

Type of poll to create

See poll types below

Poll type options

Poll Type

Value

Description

Head-to-Head

TurkJobPoll

Compare two options directly

Ranked

TurkJobPollMulti

Rank multiple options in order

Open-Ended

TurkJobFeedback

Collect written feedback

Click-Test

ClickTest

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.

Did this answer your question?