Add Candidate To Talent Pool

POST

/api/v1/talent-pools/{talent_pool_id}/add-candidate/

Last modified:2025-06-02 14:40:30

Adds a new candidate manually to a specific talent pool belonging to the authenticated company.

Arguments

talent_pool_id (integer , as path parameter): The unique identifier of the talent pool to which the candidate should be added.

Example: talent_pool_id=42

email (string, as body parameter) : Candidate's email address (must be unique in the talent pool).

Example: "johndoe@example.com"

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

Example: "John"

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

Example: "Doe"

cv (string, as body parameter) : Document ID of uploaded candidate CV via utilities/upload-file/ endpoint.

Example: "20170"

Returns

201 Created: A JSON object representing the newly created candidate with full detail, including presigned URLs for CV/photo if available.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Body Params application/json

Examples

Responses

🟢201Created

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.recruspace.com/api/v1/talent-pools//add-candidate/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "first_name": "string",
    "last_name": "string",
    "email": "user@example.com",
    "cv": 0,
    "source_platform": "string"
}'

Response Example

{
    "id": 0,
    "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:22Z"
        }
    },
    "job_post": {
        "hash": "string",
        "title": "string"
    },
    "source_job_post": {
        "hash": "string",
        "title": "string"
    },
    "company": "string",
    "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:22Z"
    },
    "photo": {
        "id": 0,
        "path": "string",
        "name": "string",
        "type": "string",
        "file_size": -2147483648,
        "base": "string",
        "presigned_url": "string",
        "uploaded_at": "2019-08-24T14:15:22Z"
    },
    "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
        }
    ],
    "tags": [
        {
            "id": 0,
            "title": "string"
        }
    ],
    "suitability": "suitable",
    "score": 0,
    "summary": "string",
    "skills": "string",
    "total_work_experience": 0,
    "seniority": "string",
    "company_pipeline": {
        "id": 0,
        "queue": -2147483648,
        "name": "string",
        "key": "string",
        "created_at": "2019-08-24T14:15:22Z"
    },
    "rejected_mail_sended": true,
    "source_platform": "string",
    "source_type": "applied_from_candidate",
    "error_status": true,
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
}

Modified at 2025-06-02 14:40:30

Delete Talent Pool

Talent Pool Candidates