Completion Codes

Generate completion codes for respondent tracking. Works with research panel platforms including Prolific, Amazon MTurk, CloudResearch, Respondent, Positly, and Cint to verify survey completions and approve payments.

Quick Start

Set up completion codes for research panel participants:

Open Panel Integrations - Open your survey and navigate to Panel Integrations in the sidebar
Enable a platform - Toggle on the platform you are using (Prolific, MTurk, etc.)
Enter completion code - Add the code in the "Completion Code" field
Set completion URL - For platforms that support redirect, enter the completion URL
Copy survey URL - Use the generated URL with parameters in your platform

For detailed platform setup, see Research Panel Integrations.

How It Works

Completion codes verify that participants finished your survey:

Participant starts survey - Platform parameters are captured from the URL
Survey completed - Participant answers all required questions
Code displayed or redirected - Participant sees code or is redirected to platform
Code verified - You match codes between survey data and platform submissions
Payment approved - Approve participants who completed successfully

Setting Up Completion Codes

Per-Platform Configuration

Completion codes are configured per research panel platform:

Open your survey settings
Go to Panel Integrations
Enable the platform you are using
Enter the Completion Code (e.g., "CHHXQERF")
Configure optional redirect URLs
Save your settings

Platform-Specific Behavior

Platform	Code Behavior
Prolific	Auto-redirect with code in URL
CloudResearch	Auto-redirect with code in URL
Respondent	Auto-redirect with code in URL
MTurk	Code displayed, participant enters manually
Positly	Configure redirect URL
Cint	Configure redirect URL

Redirect URLs

For platforms that support auto-redirect, the participant is automatically sent back to the platform with the completion code. Default redirect URLs:

Platform	Default Redirect URL
Prolific	`https://app.prolific.com/submissions/complete?cc={code}`
CloudResearch	`https://connect.cloudresearch.com/participant/project/{project_id}/complete?code={code}`
Respondent	`https://app.respondent.io/r/done?code={code}`

You can override these with custom URLs in the Advanced Redirect URLs section.

Advanced Redirect Options

Each platform supports additional redirect URLs:

URL Type	Purpose
Custom Completion URL	Override the default completion redirect
Screenout URL	Redirect participants who are screened out
Quota Full URL	Redirect when survey quota is reached

Thank-You Page

When not using auto-redirect, participants see a thank-you page with:

Completion confirmation message
Completion code prominently displayed
Copy button for easy copying
Instructions for submitting the code

Custom Completion Message

Customize the thank-you message in your survey's Completion Settings:

Thank you for completing our survey!

Your completion code is displayed below.
Please copy this code and enter it in [Platform] to receive your payment.

FairMatch Codes

For unique participant identification across studies, use FairMatch Codes instead. FairMatch generates a unique code for each respondent that can be used to track participation across multiple surveys.

Verifying Completions

Manual Verification

Export your survey responses (includes completion timestamps)
Download platform submissions
Match participant IDs between datasets
Approve matching submissions

In Response Data

Each response includes:

Platform parameters (participant ID, study ID, etc.)
Completion timestamp
FairMatch code (if enabled)

Real-World Examples

Example: Prolific Study

Platform: Prolific (enabled)
Completion Code: CPXYZ123
Redirect: Auto (default Prolific URL)

Flow:
1. Participant clicks link with PROLIFIC_PID, STUDY_ID, SESSION_ID
2. Survey captures parameters
3. Participant completes survey
4. Auto-redirect to Prolific with code CPXYZ123
5. Prolific marks submission as complete

Example: MTurk HIT

Platform: MTurk (enabled)
Completion Code: 847291

HIT Instructions:
"Complete the survey and enter the code shown on the final page."

Flow:
1. Worker clicks link with workerId, assignmentId, hitId
2. Survey captures parameters
3. Worker completes survey
4. Thank-you page shows code: 847291
5. Worker enters code in MTurk HIT
6. You verify and approve

Example: Multi-Platform Study

Platforms enabled:
- Prolific: Code "PROL-DONE"
- CloudResearch: Code "CR-COMPLETE"
- MTurk: Code "MTK12345"

Each platform has its own completion code and redirect settings.
Participants from each platform see their platform-specific code.

Plan Availability

Feature	Free	Pro	Business	Enterprise
Completion codes	-	Yes	Yes	Yes
Auto-redirect	-	Yes	Yes	Yes
Custom redirect URLs	-	Yes	Yes	Yes
Screenout redirect	-	Yes	Yes	Yes
Quota full redirect	-	Yes	Yes	Yes

Completion codes are part of the panel integration features. Pro plan supports Prolific; Business and above support all platforms.

Troubleshooting

Issue: Code not displaying

Symptoms: Thank-you page shows no completion code.

Solutions:

Verify the platform is enabled in Panel Integrations
Check that a completion code is entered
Ensure the participant came from that platform (URL had parameters)

Issue: Redirect not working

Symptoms: Stays on thank-you page instead of redirecting.

Solutions:

Check if the platform supports auto-redirect
Verify custom redirect URL is valid
Test with browser developer tools for errors

Issue: Wrong code displayed

Symptoms: Participant sees wrong or no code.

Solutions:

Verify which platform the participant came from
Check URL parameters were captured
Review platform configuration

Best Practices

Use descriptive codes - Makes verification easier
Test the flow - Complete survey yourself from each platform
Verify before paying - Match platform submissions to responses
Configure all redirects - Set screenout and quota URLs for better UX
Keep records - Export data includes platform parameters for audit trail