Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.firstwork.com/llms.txt

Use this file to discover all available pages before exploring further.

A slug is a short, URL-friendly identifier that you can assign to any question in your hiring flow form. When a candidate opens an application link that includes the slug as a URL parameter, the corresponding question is automatically pre-filled with the value from the URL.

How It Works

  1. Assign a slug to a question in the form builder (e.g., source, location, referral_code)
  2. Append the slug as a URL parameter to the funnel link
  3. When the candidate opens the link, the question is automatically pre-filled with the value

Example

If you have a question with the slug source, your funnel link would look like:
https://app.firstwork.com/apply/your-funnel?source=LinkedIn
When the candidate opens this link, the “source” question will already be filled in with “LinkedIn”. You can pass multiple slugs in the same URL:
https://app.firstwork.com/apply/your-funnel?source=LinkedIn&location=New+York&referral_code=REF123

Common Use Cases

SlugPurpose
sourceTrack where the candidate came from (job board, social media, referral)
locationPre-fill the work location based on the job listing
referral_codeCapture referral information from the link
positionPre-fill the role or position title
campaignTrack which marketing campaign drove the application

Setting Up Slugs

  1. Open your hiring flow in the form builder
  2. Select the question you want to make pre-fillable
  3. In the question settings, enter a slug value
  4. Share the funnel link with the slug as a URL parameter
Slugs must be unique within a form. Use lowercase letters, numbers, and underscores (e.g., referral_code).