Recruspace
  1. Endpoints
Recruspace
  • Welcome
  • Get API Key
  • Authentication
  • Rate Limit
  • Pagination
  • Endpoints
    • Companies Offices
      GET
    • Companies Users
      GET
    • Job Posts
      GET
    • Job Post
      GET
    • Apply Job
      POST
    • Job Questions
      GET
    • Talent Pools
      GET
    • Update Talent Pool
      PATCH
    • Delete Talent Pool
      DELETE
    • Add Candidate To Talent Pool
      POST
    • Talent Pool Candidates
      GET
    • Create Talent Pool
      POST
    • Upload File
      POST
  1. Endpoints

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 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 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
Previous
Delete Talent Pool
Next
Talent Pool Candidates
Built with