# reject_recruiter_applicant: Reject a Recruiter applicant

Reject one applicant in a hiring project, with a reason. This action can change or spend something, and it happens right away. Plan: Free and Connect.

```
POST https://api.heyreagent.com/v1/actions/reject_recruiter_applicant
Authorization: Bearer YOUR_KEY
content-type: application/json

{
  "applicantId": "PASTE_RECRUITER_ID_HERE",
  "hiringProjectId": "PASTE_HIRING_PROJECT_ID_HERE",
  "reason": "NOT_MEET_BASIC_QUALIFICATIONS"
}
```

## What you give it

- `applicantId` (needed): a Recruiter id. The applicant's Recruiter id (AE…). Where to get it: Run `search_linkedin_recruiter_people` and use `results[].id`.
- `hiringProjectId` (needed): a hiring project id. The hiring project (from list_hiring_projects). Where to get it: Run `list_hiring_projects` and use `projects[].id`.
- `reason` (needed): one of: NOT_MEET_BASIC_QUALIFICATIONS, NOT_IN_DESIRED_LOCATION, MORE_QUALIFIED_CANDIDATES, WITHDREW_APPLICATION, NOT_CONSIDERED_OR_REASON_NOT_SPECIFIED. 
- `notifyMessage` (optional): text, up to 4000 characters. Text of the rejection notice to send the applicant. Omit to reject without telling them.
- `notifyAt` (optional): a date and time, like 2026-10-01T00:00:00.000Z. When to send the notice (ISO 8601 UTC). Default: now.
- `connectionId` (optional): a connection id. Which of your LinkedIn accounts to act from (its id from list_linkedin_accounts). Omit to use your first live one. Where to get it: Run `list_linkedin_accounts` and use `accounts[].id`.

## What you get back

- `rejected`
- `applicantId`
- `hiringProjectId`
- `reason`
- `notified`
- `from`: the account it ran on
- `usedToday`: number
- `dailyLimit`: number

## Good to know

- applicantId is the person's Recruiter id, not the applicant id that list_job_applicants returns.

Page: https://heyreagent.com/docs/actions/reject_recruiter_applicant