Recruspace
  1. Endpoints
Recruspace
  • Welcome
  • Get API Key
  • Authentication
  • Rate Limit
  • Pagination
  • Endpoints
    • Get Candidate
      GET
    • Create Candidate
      POST
    • Add Note to Candidate
      POST
    • Add Tag to Candidate
      POST
    • Add Candidate to Job Post or Talent Pool
      POST
    • Search Candidate by Email
      GET
    • List Company Offices
      GET
    • List Company Users
      GET
    • List Job Posts
      GET
    • Get Job Post
      GET
    • Apply to Job Post
      POST
    • List Job Post Questions
      GET
    • List Talent Pools
      GET
    • Update Talent Pool
      PATCH
    • Delete Talent Pool
      DELETE
    • List Talent Pool Candidates
      GET
    • Create Talent Pool
      POST
    • Upload File
      POST
  1. Endpoints

Add Candidate to Job Post or Talent Pool

POST
/api/v1/client/candidates/manual-add/
Last modified:2025-12-30 13:07:46
Adds a new candidate manually to a specific talent pool or job post belonging to the authenticated company.
Arguments
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"
job_post (string, as body parameter) : The unique identifier of the job post to which the candidate should be added.
Example: "ab8fefa4e436e9462f2952f53cd8c"
talent_pool_id (integer , as body parameter): The unique identifier of the talent pool to which the candidate should be added.
Example: 123
Returns
201 Created: A JSON object representing the newly created candidate with full detail, including presigned URLs for CV/photo if available.

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢201
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.recruspace.com/api/v1/client/candidates/manual-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": 0,
    "source_platform": "api"
}'
Response Response Example
{
    "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"
}
Modified at 2025-12-30 13:07:46
Previous
Add Tag to Candidate
Next
Search Candidate by Email
Built with