Features Pricing FAQ Resources Documentation Our Story Blog Product Updates
Log in Start free →

Documentation

Everything you need to embed surveys, configure triggers, and understand your results.

Quick start

From account to live survey in under 5 minutes.

  1. Sign up at thinpoll.com and create your first survey.
  2. Choose a survey type and write your question.
  3. Copy the embed snippet from the survey dashboard.
  4. Paste it into your website's HTML, just before </body>.
  5. Publish — responses start coming in immediately.

Installation

Add the ThinPoll widget to any website with one script tag.

Paste the following snippet into your HTML. Replace YOUR_SURVEY_ID with the ID from your survey dashboard.

<!-- ThinPoll widget --> <script src="https://www.thinpoll.com/survey-widget.js" data-survey-id="YOUR_SURVEY_ID" async> </script>
The widget is cookieless. No consent banner required for the widget itself. It works via anonymous session fingerprinting.

You can also pass optional attributes to control behaviour:

AttributeDefaultDescription
data-survey-idRequired. Your survey's unique ID.
data-delay3000Milliseconds before the widget appears.
data-positionbottom-rightWidget position: bottom-right, bottom-left, center.
data-themelightColor theme: light or dark.

Survey types

Pick the format that fits the question.

NPS (0–10 scale)Ask "How likely are you to recommend us?" Get a Net Promoter Score over time.

Rating (1–5 stars)Quick satisfaction check after an interaction or feature use.

Multiple choiceUp to 6 options. Good for "Why are you leaving?" or feature preference questions.

Open textA short text input for qualitative feedback. Works best as a follow-up to a rating question.

Triggers

Control when your survey appears.

TriggerBehaviour
Time delayShow after N seconds on page. Good for first impressions.
Scroll depthShow after the user scrolls past a percentage of the page. Good for blog posts and landing pages.
Exit intentShow when the mouse moves toward the browser chrome (desktop) or after a fast back-scroll (mobile). Good for checkout or pricing pages.
Manual / programmaticCall ThinPoll.show() from your own JavaScript whenever you decide.
// Programmatic trigger example ThinPoll.show();

Teams

Share access with your colleagues.

Go to Settings → Team and invite colleagues by email. Two roles are available:

RoleAccess
AdminCreate and delete surveys, manage team members, billing.
ViewerView surveys and responses. Cannot create or delete anything.

Team features are available on Pro and Business plans.

Notifications

Get alerted when responses come in.

Connect your survey to Slack, Microsoft Teams, or a custom webhook in Survey settings → Notifications.

OptionDetails
SlackPaste your Slack Incoming Webhook URL. A message is sent per response or in digest batches.
Microsoft TeamsPaste your Teams Incoming Webhook URL. Same format.
Custom webhookAny URL that accepts a POST with JSON body: { surveyId, response, timestamp }.

Set a cooldown (e.g. minimum 30 minutes between notifications) to avoid noise during traffic spikes.

REST API

Integrate ThinPoll with Zapier, Make, or your own code.

Generate an API key in your dashboard under Account → API Keys. Choose which scopes the key can use, then use it in any HTTP client.

ScopeAccess
surveys:readList all your surveys.
surveys:writeCreate surveys programmatically.
responses:readExport responses for any of your surveys.

All requests use the Authorization: Bearer tp_live_… header. Base URL: https://www.thinpoll.com/api/v1

# List surveys curl https://www.thinpoll.com/api/v1/surveys \ -H "Authorization: Bearer tp_live_YOUR_KEY" # Create a survey curl -X POST https://www.thinpoll.com/api/v1/surveys \ -H "Authorization: Bearer tp_live_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"name": "Pricing page feedback", "template": "nps"}' # Export responses curl https://www.thinpoll.com/api/v1/surveys/SURVEY_ID/responses \ -H "Authorization: Bearer tp_live_YOUR_KEY"
API keys are shown only once when created. Store them securely. Rate limit: 60 requests per minute per key.

WordPress Plugin

Embed ThinPoll on any WordPress site — no code required.

Download the free ThinPoll plugin from your dashboard under Account → API Keys → WordPress Plugin, or directly at thinpoll.com/thinpoll.zip. Upload it to your WordPress site and activate it — the widget starts loading on every page once you enter your Survey ID.

  1. Download thinpoll.zip from the ThinPoll dashboard.
  2. In WordPress admin go to Plugins → Add New → Upload Plugin.
  3. Upload the ZIP and click Activate.
  4. Go to Settings → ThinPoll and enter your Survey ID.
  5. Enable the widget and save. Done — the survey appears on every page.
SettingDescription
Survey IDThe UUID of the survey to show. Copy it from your ThinPoll dashboard.
TriggerTime delay (3–30 s), scroll depth (50 % / 75 %), or exit intent.
LanguageOverride the widget language: EN, DE, FR, or ES.
Enable widgetMaster switch to show or hide the widget site-wide.
The plugin uses wp_footer to inject a single script tag. No cookie banner needed — the widget is fully cookieless and §25 TTDSG does not apply.

GDPR & cookies

How ThinPoll handles data and why no cookie banner is needed.

The ThinPoll widget uses no cookies, no localStorage, and no persistent tracking. Response deduplication is based on an anonymous in-memory session fingerprint that expires when the tab is closed.

Survey responses are stored in the EU (Germany West Central) and are never shared with third parties. No personal data is collected unless you add an open-text field and the user voluntarily enters their name or email.

Under GDPR, processing is based on legitimate interest (collecting product feedback does not require consent). You do not need to add ThinPoll to your cookie banner.

If you collect email or name via an open-text field, mention ThinPoll in your privacy policy as a sub-processor.