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

# Linking with the Impirica Platform

> How Neurapulse connects to Impirica platform products such as ExceleRATE and DriveABLE using Reference IDs and Redirect URIs.

If your organisation already uses an Impirica platform product — such as ExceleRATE or DriveABLE — you can link it to Neurapulse so that a test you run here flows back into your existing system. Linking lets you:

* **Match a Neurapulse result to the right person** in your own platform, using a **Reference ID**.
* **Send a test taker back to your own page** after they finish, using a **Redirect URI**.

These two features work independently — you can use either on its own — but together they make a complete round trip between your platform and Neurapulse.

## The Two Building Blocks

<Columns cols={2}>
  <Card title="Reference ID" icon="hashtag" href="/docs/Integrations/reference-ids">
    A correlation key. You attach your own identifier (an employee number, a subject ID, or any record key) to a test taker so the result can be matched back to your system.
  </Card>

  <Card title="Redirect URI" icon="arrow-right-from-bracket" href="/docs/Integrations/redirect-uris">
    A return destination. After a test taker completes their assessment, their browser is sent back to a page you control — as long as that page is on your approved list.
  </Card>
</Columns>

## How Linking Works

Linking has two separate paths. Understanding the split is important: **the result score never travels back through the test taker's browser.** It is only ever delivered through a secure, server-to-server connection.

<Steps>
  <Step title="Your platform sends the test taker into Neurapulse">
    A personalised test link is generated for the test taker. When your connected platform creates that link, it can carry two pieces of information:

    * a **Reference ID** — your record's identifier for this person, and
    * a **Redirect URI** — the page you want the test taker returned to afterwards.
  </Step>

  <Step title="The test taker completes the assessment">
    The test taker opens the link, signs in, and takes the assessment in Neurapulse exactly as any other test taker would.
  </Step>

  <Step title="The test taker is redirected back to you">
    When the assessment finishes, Neurapulse checks the Redirect URI against your workspace's approved list. If it matches, the test taker's browser is sent back to that page.

    <Warning>
      No result data is added to the return URL — no score, no pass/fail, no Reference ID. The redirect simply returns the test taker to your page. The result is retrieved separately (next step).
    </Warning>
  </Step>

  <Step title="Your platform retrieves the result securely">
    Separately — and on your own schedule — your Impirica platform retrieves the result through a secure connection between the two systems. That response includes the **Reference ID** you supplied, so your platform can match the result back to the correct record.
  </Step>
</Steps>

<Info>
  Because the score is delivered only through the secure server-to-server connection and never through the browser, it cannot be read or tampered with by the test taker.
</Info>

## Is This Only for ExceleRATE?

No. Reference IDs and Redirect URIs are not specific to any one product:

* **Reference IDs** are a general-purpose field. Any system — ExceleRATE, DriveABLE, or even your own HR or payroll system — can use them.
* **Redirect URIs** are managed per workspace and work the same way regardless of which platform sends the test taker in.

Programmatic result retrieval (the final step above) is the part that is set up per connected product. If you want a different Impirica product such as DriveABLE to pull results automatically, that connection is arranged during onboarding. Talk to your Neurapulse contact to set it up.

## Next Steps

<Columns cols={2}>
  <Card title="Set a Reference ID" icon="hashtag" href="/docs/Integrations/reference-ids">
    Attach your own identifier to a test taker.
  </Card>

  <Card title="Manage Redirect URIs" icon="list-check" href="/docs/Integrations/redirect-uris">
    Approve the pages test takers can be returned to.
  </Card>
</Columns>