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 over a week ago

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-8

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

H2H

Compare two options directly

Ranked

Ranked

Rank multiple options in order

Open-Ended

Open

Collect written feedback

Star Rating

Rating

Rate options using stars

Click Test

Click

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=H2H

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 URLs

Head-to-Head logo comparison

https://app.pickfu.com/ask/survey?question=Which%20logo%20better%20represents%20our%20brand%3F&num_options=2&num_responses=100&poll_type=H2H&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

Ranked poll for Amazon sellers

https://app.pickfu.com/ask/survey?poll_type=Ranked&num_options=3&question=If%20you%20were%20shopping%20on%20Amazon%2C%20which%20image%20would%20make%20you%20click%20on%20the%20product%3F&country=US&targeting=amznpr

Open-ended feedback poll

https://app.pickfu.com/ask/survey?poll_type=Open&num_options=1&question=What%20questions%20do%20you%20have%20about%20this%20product%3F&num_responses=50

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?