Create Candidate

Adds a new candidate to a specific talent pool or job post via integration (n8n, Zapier, Make, etc.).

Arguments

first_name (string, as body parameter, required) : Candidate's first name.

Example: "John"

last_name (string, as body parameter, required) : Candidate's last name.

Example: "Doe"

email (string, as body parameter, required) : Candidate's email address.

Example: "johndoe@example.com"

cv_file (file, as body parameter, required) : CV file to upload (PDF, DOCX, or DOC format).

job_post (string, as body parameter, optional) : The unique hash identifier of the job post.

Example: "ab8fefc74a4e436e9462f2952f53cd8c"

talent_pool_id (integer, as body parameter, optional) : The unique identifier of the talent pool.

Example: 123

phone_number (string, as body parameter, optional) : Candidate's phone number.

Example: "+1234567890"

Returns

201 Created : A JSON object representing the newly created candidate with full details.

400 Bad Request : If validation fails (e.g., missing required fields, invalid file format).

409 Conflict : If a candidate with the same email already exists in the specified job post or talent pool.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --request POST 'https://api.recruspace.com/api/v1/client/candidates/add/' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "job_post": "string", "talent_pool_id": 0, "first_name": "string", "last_name": "string", "email": "user@example.com", "cv_file": "string", "phone_number": "string" }'

{ "id": 0, "company": "string", "user": { "id": 0, "email": "user@example.com", "first_name": "string", "last_name": "string", "profile_img": { "id": 0, "path": "string", "name": "string", "type": "string", "file_size": -2147483648, "base": "string", "presigned_url": "string", "uploaded_at": "2019-08-24T14:15:22.123Z" } }, "job_post": { "hash": "string", "title": "string", "status": "draft", "pipeline": 0 }, "initial_applied_job_post": { "hash": "string", "title": "string", "status": "draft", "pipeline": 0 }, "substage": { "id": 0, "stage": { "id": 0, "name": "string", "key": "string", "created_at": "2019-08-24T14:15:22.123Z", "pipeline": 0 }, "name": "string", "queue": -2147483648, "is_visible": true, "created_at": "2019-08-24T14:15:22.123Z", "email_template": 0 }, "email": "user@example.com", "first_name": "string", "last_name": "string", "cv": { "id": 0, "path": "string", "name": "string", "type": "string", "file_size": -2147483648, "base": "string", "presigned_url": "string", "uploaded_at": "2019-08-24T14:15:22.123Z" }, "photo": { "id": 0, "path": "string", "name": "string", "type": "string", "file_size": -2147483648, "base": "string", "presigned_url": "string", "uploaded_at": "2019-08-24T14:15:22.123Z" }, "phone_number": "string", "address": "string", "city": "string", "country": "string", "education": [ { "school_name": "string", "degree": "bachelor", "major": "string", "start_date": "2019-08-24", "end_date": "2019-08-24", "currently_pursuing": true } ], "work_experience": [ { "company_name": "string", "position_title": "string", "employment_type": "full_time", "start_date": "2019-08-24", "end_date": "2019-08-24", "currently_employed": true } ], "links": [ { "platform": "linkedin", "url": "string" } ], "tags": [ { "id": 0, "title": "string" } ], "suitability": "suitable", "is_pinned": true, "is_parsed": true, "score": 0, "skills": [ "string" ], "total_work_experience": 0, "seniority": "string", "is_seen": true, "rejected_mail_sended": true, "source_platform": "api", "entry_method": "applied", "error_status": true, "created_at": "2019-08-24T14:15:22.123Z", "updated_at": "2019-08-24T14:15:22.123Z" }

Request

Responses