> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pastahr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Application Links: Build, Share, and Track Your URLs

> Learn how PastaHR application links work, how to generate them, and how to add UTM tracking to pinpoint where your applicants come from.

## Anatomy of a PastaHR Application Link

A PastaHR application link is a URL that determines which flow it starts and which job the application gets linked to.

**Example:**

```text theme={null}
https://conv.pastahr.com/r/ORGXXXX?remote_job_id={ATS_JOB_ID}&remote_job_name={JOB_NAME}&utm_source=linkedin&utm_medium=social&utm_campaign=summer-hiring
```

The flow identifier follows the pattern `ORGXXXX`, where `ORG` is your organisation's unique prefix (the same for all your flows) and `XXXX` is the individual flow identifier.

| Parameter         | Description                                                                                                                              |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `Flow ID`         | The unique code for the PastaHR conversation flow to launch (e.g. `TEST0001`).                                                           |
| `remote_job_id`   | The job identifier from your ATS.<br />This is how PastaHR forwards the completed application to the right vacancy.                      |
| `remote_job_name` | The display name of the job.                                                                                                             |
| `platform`        | Specifies the channel: `wa` for WhatsApp, `web` for the online application, `insta` for Instagram.<br />Defaults to WhatsApp if omitted. |
| `utm_source`      | The traffic source (e.g. `linkedin`, `facebook`, `email`).                                                                               |
| `utm_medium`      | The marketing channel (e.g. `social`, `cpc`, `newsletter`).                                                                              |
| `utm_campaign`    | The campaign name (e.g. `summer-hiring-2026`).                                                                                           |
| `utm_content`     | Differentiates ads or links within the same campaign.                                                                                    |
| `utm_term`        | Captures the keyword that triggered the ad.                                                                                              |

<Warning>
  **With ATS integration**: if you share an application link **without** a `remote_job_id`, PastaHR cannot reliably associate the incoming application with a specific vacancy in your ATS.

  **Without ATS integration**: without `remote_job_name`, the application can't be filtered by job in the applications overview. So set `remote_job_name` on every link.
</Warning>

## Generating an Application Link in PastaHR

PastaHR's built-in Link Builder handles constructing the URL, including the correct flow identifier, the `remote_job_id` from your connected ATS, and any UTM parameters.

<Steps>
  <Step title="Navigate to the Link Builder">
    <Tabs>
      <Tab title="With ATS Integration">
        Click **Jobs** in the left sidebar, select the job posting you want to share, and click **Create Link**. The Link Builder opens with the ATS job ID and job name already pre-filled.
      </Tab>

      <Tab title="Without ATS Integration">
        Click **Links** directly in the left sidebar, then click **Create Link**.
      </Tab>
    </Tabs>
  </Step>

  <Step title="Select a flow and confirm the job assignment">
    Choose the application flow you want to use.
  </Step>

  <Step title="Add UTM parameters (optional)">
    Fill in the UTM fields for source, medium, and campaign if you want to track where applicants come from. See [UTM Tracking](/en/recruiters/utm-tracking) for more information.
  </Step>

  <Step title="Copy and distribute the link">
    Click **Copy Link**.
  </Step>
</Steps>

## Checking Whether a Link Is Working

After generating a link, it's worth testing it before launching a campaign.

<Steps>
  <Step title="Open the link in a private/incognito window">
    This avoids cached sessions that could interfere with the test.
  </Step>

  <Step title="Verify the flow launches correctly">
    Confirm that the correct job title and questions appear in the conversation.
  </Step>

  <Step title="Check the ATS after completing a test application">
    Submit a test application and check that it appears under the correct vacancy in your ATS within a few minutes.
  </Step>
</Steps>

<Note>
  If the link opens a "job not active" message, check whether the vacancy is published and active in your ATS **and** whether the `remote_job_id` in the link exactly matches the job ID in the ATS. See the [ATS Troubleshooting guide](/en/recruiters/ats-troubleshooting) for more details on this error.
</Note>