> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Edit Candidate

Update a single candidate by its ID.

<Note>
  External Documentation

  To learn more, visit the [Greenhouse documentation](https://developers.greenhouse.io/harvest.html#patch-edit-candidate).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter         | Description                                                                                    |
  | ----------------- | ---------------------------------------------------------------------------------------------- |
  | Candidate ID      | The candidate ID of the candidate to edit. Can be obtained using the `List Candidates` action. |
  | Company           | The candidate's company.                                                                       |
  | Coordinator Email | The email of the new coordinator. Either the ID or email must be present.                      |
  | Coordinator ID    | The ID of the new coordinator. Either the ID or email must be present.                         |
  | First Name        | The candidate's first name.                                                                    |
  | Last Name         | The candidate's last name.                                                                     |
  | On Behalf Of      | ID of the user issuing this request. Required for auditing purposes.                           |
  | Recruiter Email   | The email of the new recruiter. Either the ID or email must be present.                        |
  | Recruiter ID      | The ID of the new recruiter. Either the ID or email must be present.                           |
  | Title             | The candidate's title.                                                                         |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter              | Description                                                                                                                                                                                                                 |
  | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Addresses              | A json array of addresses.<br />For example:<br /><pre><code>\[<br />  \{<br />    "value": "123 Fake St.",<br />    "type": "home"<br />  }<br />]</code></pre>                                                            |
  | Custom Fields          | The custom fields of the user. For more information regarding this parameter, refer to [Greenhouse's Documentation](https://developers.greenhouse.io/harvest.html#patch-edit-candidate) under \`Custom Field Parameters'.   |
  | Email Addresses        | A json array of email addresses.<br />For example:<br /><pre><code>\[<br />  \{<br />    "value": "[john.locke+work@example.com](mailto:john.locke+work@example.com)",<br />    "type": "work"<br />  }<br />]</code></pre> |
  | Is Private             | Whether the candidate is private or not.                                                                                                                                                                                    |
  | Phone Numbers          | A json array of phone numbers.<br />For example:<br /><pre><code>\[<br />    \{<br />        "value": "222-555-4608",<br />        "type": "home"<br />    }<br />]</code></pre>                                            |
  | Social Media Addresses | A json array of social media addresses.<br />For example:<br /><pre><code>\[<br />  \{<br />    "value": "linkedin.example.com/john.locke"<br />  }<br />]</code></pre>                                                     |
  | Tags                   | A json array of tags as strings.<br />For example:<br /><pre><code>\[<br />  "Walkabout",<br />  "Orientation"<br />]</code></pre>                                                                                          |
  | Website Addresses      | A json array of website addresses.<br />For example:<br /><pre><code>\[<br />  \{<br />    "value": "johnlocke.example.com",<br />    "type": "personal"<br />  }<br />]</code></pre>                                       |
</div>

## Example Output

```json theme={"dark"}
{
	"first_name": "New",
	"last_name": "Name",
	"company": "The Tustin Box Company",
	"title": "Customer Success Representative",
	"is_private": true,
	"phone_numbers": [
		{
			"value": "555-1212",
			"type": "mobile"
		}
	],
	"addresses": [
		{
			"value": "123 Fake St.",
			"type": "home"
		}
	],
	"email_addresses": [
		{
			"value": "john.locke+work@example.com",
			"type": "work"
		},
		{
			"value": "john.locke@example.com",
			"type": "personal"
		}
	],
	"website_addresses": [
		{
			"value": "johnlocke.example.com",
			"type": "personal"
		}
	],
	"social_media_addresses": [
		{
			"value": "linkedin.example.com/john.locke"
		},
		{
			"value": "@johnlocke"
		}
	],
	"recruiter": {
		"user_id": 4354
	},
	"coordinator": {
		"email": "coordinator@example.com"
	},
	"tags": [
		"Walkabout",
		"Orientation"
	],
	"custom_fields": [
		{
			"id": 1234,
			"value": "Some new value"
		},
		{
			"name_key": "single_select_field_name",
			"value": 12345
		},
		{
			"id": 5678,
			"delete_value": "true"
		}
	]
}
```

## Workflow Library Example

[Edit Candidate with Greenhouse and Send Results Via Email](https://library.blinkops.com/workflows/edit-candidate-with-greenhouse-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/edit-candidate-with-greenhouse-and-send-results-via-email/canvas" />
</div>
