ATS Application Creation

To automate application submission from your website into the ATS, follow this sequence.

Step 1. Find the job

Find the target job to get its job_id and linked pipeline_id.

• Method: POST /api/v1/jobs/search

Step 2. Determine the pipeline stage

Fetch available stages for the selected pipeline and choose the required stage ID.

• Method: GET /api/v1/pipelines/all
• Action: find the target pipeline_id and select stage.id

Step 3. Select the source

Fetch the source directory so you can specify where the application came from.

• Method: GET /api/v1/sources/all
• Action: store the required source_id

Step 4. Upload the resume file

Upload a PDF, DOC, or DOCX resume for automatic parsing.

• Method: POST /api/v1/upload-cv-file
• Format: multipart/form-data
• Result: store the returned cv_id

Step 5. Create the applicant

Create the applicant card using parsed data or data entered by the user.

• Method: POST /api/v1/applicant
• Important: pass cv_ids from the previous step so the file is attached

Step 6. Assign the applicant to the job

Link the applicant to the job on the selected stage.

• Method: POST /api/v1/candidate
• Pass: job_id, applicant_id, pipeline_id, pipeline_stage_id

Step 7. Move the candidate or add a comment

You can move the candidate through the pipeline, disqualify them, or leave comments.

• Method: POST /api/v1/candidates/{candidate_id}/actions
• Method: DELETE /api/v1/candidates/{candidate_id}/actions/{id}

Example fields:

pipeline_stage_id: target stage ID
disqualification_reason_id: rejection reason
reserved: move candidate to reserve
comment: comment text
datetime_action_date: optional date for historical actions

If datetime_action_date is provided, the candidate’s current stage may stay unchanged. Use it mainly for backfilling missed historical events.