Careers Page Integration
Add a single link to your job listings that launches candidates straight into a TalentPrism AI interview — no unique URLs needed per job.
1. Base Endpoint
https://app.talentprism.ai/sequence/redirect/2. GET vs POST
Use GET when you are only pre-filling candidate details.
Fleet resolves the correct sequence from team and job, then either auto-launches or shows the candidate form depending on the available data and sequence settings.
Use POST multipart/form-data when you need to send a resume file.
The same endpoint resolves the sequence, creates or updates the candidate, saves the resume, creates the interview, and redirects the candidate to the interview URL.
3. Required Routing Parameters
| Param | Description | Example |
|---|---|---|
| team | Your TalentPrism team slug | acmecorp |
| job | Your internal client_job_id or any ID in grouped_client_job_ids | 213304 |
If either parameter is missing or invalid, the candidate will see a 400 error.
4. Optional Candidate Fields
| Param | Maps To | Example |
|---|---|---|
| tbfname | First Name | Maria |
| tblname | Last Name | Gonzalez |
| tbemail | [email protected] | |
| tbphn | Phone (E.164) | +15551234567 |
- First & last name are required for automatic launch.
- You must supply either email or phone.
- For POST submissions, send
first_name,last_name,email,phone_number, andconsent_path=fast-track. The legacy query aliases remain supported for GET links. - If all required data is present the candidate goes straight to the interview.
- Otherwise they see a short form to complete the details.
5. Examples
GET minimal link (shows form):
https://app.talentprism.ai/sequence/redirect/?team=acmecorp&job=213304GET auto-launch (straight to interview when all required fields are present):
https://app.talentprism.ai/sequence/redirect/?team=acmecorp&job=213304&tbfname=Maria&tblname=Gonzalez&tbemail=maria%40example.comPOST with resume upload:
curl -X POST "https://app.talentprism.ai/sequence/redirect/" \
-F "team=acmecorp" \
-F "job=213304" \
-F "first_name=Maria" \
-F "last_name=Gonzalez" \
-F "[email protected]" \
-F "consent_path=fast-track" \
-F "resume=@/path/to/resume.pdf"Remember to URL-encode special characters (e.g. @ → %40).
6. FAQ
Do we need to POST or include a CSRF token?
Use GET for no-file redirects. Use POST multipart/form-data when sending a resume. External integrations do not need to manage a CSRF token for this endpoint.
What if the job is closed or ID is wrong?
The candidate will see a 400 error and you can adjust the link.
Can we add custom fields?
At this time only the parameters above are supported.
Do we need to know the sequence id to upload a resume?
No. The redirect endpoint still resolves the correct sequence from team and job.
Can't find what you're looking for?
Contact Us