Add Note to Candidate

POST

/api/v1/client/candidates/add-note/

Last modified:2025-12-30 13:07:46

Adds a note/comment to an existing candidate via integration (n8n, Zapier, Make, etc.).

Arguments

candidate_id (integer, as body parameter, required) : The unique identifier of the candidate.

Example: 123

text (string, as body parameter, required) : The note text to add.

Example: "Great communication skills, recommend for second interview."

Returns

201 Created : A JSON object representing the created note, including its ID, text, and timestamps.

404 Not Found : If the candidate does not exist or does not belong to the authenticated company.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.recruspace.com/api/v1/client/candidates/add-note/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "candidate_id": 0,
    "text": "string"
}'

Response Example

{
    "id": 0,
    "candidate": 0,
    "company_user": {
        "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:22.123Z"
            }
        },
        "permission": "admin",
        "role": "hiring_manager",
        "invite_status": "pending",
        "invite_code": "string",
        "invite_email": "string",
        "created_at": "2019-08-24T14:15:22.123Z",
        "updated_at": "2019-08-24T14:15:22.123Z",
        "last_login": "2019-08-24T14:15:22.123Z",
        "company": "string"
    },
    "text": "string",
    "is_external": true,
    "email": "user@example.com",
    "full_name": "string",
    "created_at": "2019-08-24T14:15:22.123Z",
    "updated_at": "2019-08-24T14:15:22.123Z"
}

Modified at 2025-12-30 13:07:46

Create Candidate

Add Tag to Candidate