POST /sourcing/invite — Send Candidate Outreach Invites

The invite endpoint sends personalized outreach messages to one or more candidates for a specific job. Candidates receive the message on WhatsApp, email, or both — with a one-click link to express interest. You can use this endpoint after generating a shortlist or with any candidate IDs from search results.

Endpoint

POST https://api.cutshort.io/v1/sourcing/invite

Request Body

string

required

The job to invite candidates for.

array of strings

required

List of candidate IDs to invite. Maximum of 50 candidate IDs per request.

string

The delivery channel for the invite. Accepted values: whatsapp, email, or both. Default: both.

string

A custom message to include in the invite (maximum 500 characters). If omitted, Cutshort uses a standard template.

Example Request

curl -X POST 'https://api.cutshort.io/v1/sourcing/invite' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "job_id": "job_4xRt2wPv",
    "candidate_ids": ["cand_8f3kL9mN", "cand_2pQr7sYk", "cand_5vNm1xBd"],
    "channel": "both",
    "message": "We found your profile impressive and would love to discuss an exciting backend role at our B2C startup."
  }'

import requests

response = requests.post(
    "https://api.cutshort.io/v1/sourcing/invite",
    json={
        "job_id": "job_4xRt2wPv",
        "candidate_ids": ["cand_8f3kL9mN", "cand_2pQr7sYk", "cand_5vNm1xBd"],
        "channel": "both",
        "message": "We found your profile impressive..."
    },
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    }
)
result = response.json()
print(f"Sent {result['sent_count']} invites")

Response

Returns 200 OK with a JSON body.

{
  "job_id": "job_4xRt2wPv",
  "sent_count": 3,
  "results": [
    { "candidate_id": "cand_8f3kL9mN", "status": "sent", "channel": "whatsapp" },
    { "candidate_id": "cand_2pQr7sYk", "status": "sent", "channel": "email" },
    { "candidate_id": "cand_5vNm1xBd", "status": "already_invited", "channel": null }
  ]
}

Candidates who have already been invited for a job in the past 30 days will have status already_invited and will not receive a duplicate message.

Invite sending is rate-limited to 500 invites per job per day. Exceeding this limit returns error code invite_limit_exceeded.

Overview

Candidates

Jobs

Sourcing

Webhooks

POST /sourcing/invite — Send Candidate Outreach Invites

Endpoint

Request Body

Example Request

Response

​Endpoint

​Request Body

​Example Request

​Response

Endpoint

Request Body

Example Request

Response