Fast-track

Fast-track is a per-candidate opt-in, the same setting as the in-app Fast-track this candidate toggle. It’s stored per candidate per owning recruiter. When a hiring manager shows interest in a ParaAI match for a fast-tracked candidate, Paraform emails the candidate directly with a link to review the role and self-submit. The owning recruiter is CC’d and notified, and keeps full ownership of the candidate. Without the opt-in, only the recruiter is notified.

The opt-in is stored, not acted on

Setting fast-track changes nothing right away. Paraform re-checks every precondition at the moment a hiring manager shows interest:

The owning recruiter is enabled for fast-track.
The candidate isn’t off the market.
A contact email is on file.
The recruiter-entered work preferences are complete.

If any of these fails at that moment, the recruiter-only flow runs instead.

Read

GET /talent-network/candidates/{candidateUserId}/fast-track (talent_network:read):

curl "https://external-api.paraform.com/api/external/v1/talent-network/candidates/$CANDIDATE_USER_ID/fast-track" \
  -H "Authorization: Bearer $PARAFORM_API_KEY"

{ "candidateUserId": "clx8k2j3a0000qz8h1b2c3d4e", "fastTrack": true, "offMarket": false }

offMarket is true while the candidate is explicitly off the market. The opt-in is still stored and returned, but it won’t fire until they’re back on the market.

Set

PUT /talent-network/candidates/{candidateUserId}/fast-track (talent_network:write, write rate tier):

curl -X PUT "https://external-api.paraform.com/api/external/v1/talent-network/candidates/$CANDIDATE_USER_ID/fast-track" \
  -H "Authorization: Bearer $PARAFORM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "fastTrack": true }'

The response echoes the stored state and matches a later GET. The write is accepted while the candidate is off the market, and offMarket: true in the response tells you it won’t fire yet. Retries converge on the same state, so no Idempotency-Key is needed.

Who can read and write

candidateUserId comes from the membership list, lookup, or batch items.

Situation	Result
The candidate is owned by an approved member of your agency	Readable
Another agency’s `candidateUserId`	`404`, the same as an id that doesn’t exist
Fast-track isn’t enabled for the candidate’s owning recruiter	`403` on both read and write. This is a Paraform-side setting the API can’t change.
Writing a candidate the key’s creator doesn’t own	`403`, even for agency owners

Writes are bound to the recruiter who created the API key: a key can only set fast-track on that recruiter’s own candidates. To change another recruiter’s candidates, use a key that recruiter created on the API Keys tab. The key list shows who created each key.

Guides

API reference

The opt-in is stored, not acted on

Read

Set

Who can read and write

​The opt-in is stored, not acted on

​Read

​Set

​Who can read and write

The opt-in is stored, not acted on

Read

Set

Who can read and write