> ## 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.

# Create Candidate

Create a new candidate profile.

<Note>
  External Documentation

  To learn more, visit the [Greenhouse documentation](https://harvestdocs.greenhouse.io/reference/post_v3-candidates).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter      | Description                                                                                           |
  | -------------- | ----------------------------------------------------------------------------------------------------- |
  | Company        | The company of the candidate.                                                                         |
  | First Name     | The first name of the candidate.                                                                      |
  | Last Name      | The last name of the candidate.                                                                       |
  | Preferred Name | The preferred or chosen name of the candidate, when different from their legal first name.            |
  | Time Zone      | The Rails-style timezone identifier of the candidate.<br />For example: `Eastern Time (US & Canada)`. |
  | Title          | The title of the candidate.                                                                           |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter              | Description                                                                                                                                                                                                                                                                                        |
  | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Addresses              | A json array of addresses.<br /><br />For example:<br /><pre><code>\[<br />  \{<br />    "value": "123 Fake St.",<br />    "type": "home"<br />  }<br />]</code></pre>                                                                                                                             |
  | Application            | A json object creating an application for the candidate. Provide `job_id` to apply the candidate to a job, or `prospect: true` with `prospect_pool_id` to add them as a prospect instead.<br />For example:<br /><pre><code>\{<br />  "job\_id": 12345,<br />  "source\_id": 1<br />}</code></pre> |
  | Can Email              | Select to indicate the candidate has consented to email communication.                                                                                                                                                                                                                             |
  | Custom Fields          | A json array of custom field objects, identified by `custom_field_id` or `name_key`, with the new `value`.<br /><br />For example:<br /><pre><code>\[<br />  \{<br />    "name\_key": "single\_select\_field\_name",<br />    "value": 12345<br />  }<br />]</code></pre>                          |
  | Email Addresses        | A json array of email addresses.<br /><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>                                                                  |
  | Linked User IDs        | A comma-separated list of user IDs to link to the candidate.                                                                                                                                                                                                                                       |
  | Phone Numbers          | A json array of phone numbers.<br /><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 /><br />For example:<br /><pre><code>\[<br />  \{<br />    "value": "linkedin.example.com/john.locke"<br />  }<br />]</code></pre>                                                                                                                      |
  | Tags                   | A comma-separated list of tags to associated with the candidate.                                                                                                                                                                                                                                   |
  | Website Addresses      | A json array of website addresses.<br /><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"}
{
	"candidate": {
		"id": 53883394,
		"first_name": "John",
		"last_name": "Doe",
		"preferred_name": null,
		"company": null,
		"title": null,
		"created_at": "2024-01-01T00:00:00.000Z",
		"updated_at": "2024-01-01T00:00:00.000Z",
		"can_email": true,
		"time_zone": null,
		"last_activity_at": "2024-01-01T00:00:00.000Z",
		"private": false,
		"tags": [],
		"linked_user_ids": [],
		"phone_numbers": [],
		"addresses": [],
		"email_addresses": [],
		"website_addresses": [],
		"social_media_addresses": [],
		"custom_fields": {}
	},
	"application": {
		"id": 2,
		"candidate_id": 53883394,
		"job_id": 12345,
		"status": "in_process",
		"created_at": "2024-01-01T00:00:00.000Z"
	}
}
```

## Workflow Library Example

[Create Candidate with Greenhouse and Send Results Via Email](https://library.blinkops.com/workflows/create-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/create-candidate-with-greenhouse-and-send-results-via-email/canvas" />
</div>
