[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Use cases](https://cotlet.dev/use-cases.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# Add candidate note

> Adds a note with a Note Action to a candidate's Notes tab. Inputs, cURL, Python and Node.js examples and an example response.

Source: https://cotlet.dev/docs/api/bullhorn/add_note

Docs sections: [Get started](https://cotlet.dev/docs.md) · [REST API](https://cotlet.dev/docs/api.md) · [MCP](https://cotlet.dev/docs/mcp.md) · [SDKs & CLI](https://cotlet.dev/docs/sdks.md) · [Integrations](https://cotlet.dev/docs/integrations.md)

Adds a note with a Note Action to a candidate's Notes tab.

Bullhorn API: https://cotlet.dev/docs/api/bullhorn.md

`POST https://cotlet.dev/api/v1/bullhorn/candidates/{candidate_id}/notes`

Access: write. Confirm: waits for the user's OK before it runs.

Saves one plain-text note on the candidate, as Actions > Add Note does. note_action must be one of the values your admin set, at most 30 characters. A name typed after @ in comments emails that user when the note is saved, so the note can reach other people. Returns the note_id. By default you confirm each call; you can switch that off for this tool.

## Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `candidate_id` | integer | yes | Candidate ID from search_candidates or find_matching_candidates. |
| `comments` | string | yes | Note text, plain text only. @name tags a user, #name references a record. |
| `note_action` | string | yes | Note Action value such as Phone Call, Email or Internal Memo, as set in your account. |
| `job_id` | integer | no | Job to reference in the note. |

## Request

**cURL**

```bash
curl -X POST https://cotlet.dev/api/v1/bullhorn/candidates/4821907/notes \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"note_action":"Phone Call","comments":"Open to contract at 90 USD/h, free from 3 Nov. Not relocating. Send the Northwind data role."}'
```

**Python**

```python
result = client.call("bullhorn", "add_note", {"candidate_id":4821907,"note_action":"Phone Call","comments":"Open to contract at 90 USD/h, free from 3 Nov. Not relocating. Send the Northwind data role."})
```

**Node.js**

```js
const result = await cotlet.call('bullhorn', 'add_note', {"candidate_id":4821907,"note_action":"Phone Call","comments":"Open to contract at 90 USD/h, free from 3 Nov. Not relocating. Send the Northwind data role."});
```

**CLI**

```bash
cotlet call bullhorn add_note --data '{"candidate_id":4821907,"note_action":"Phone Call","comments":"Open to contract at 90 USD/h, free from 3 Nov. Not relocating. Send the Northwind data role."}'
```

## Example response

```json
{
  "note_id": 6120051,
  "candidate_id": 4821907,
  "note_action": "Phone Call",
  "added_at": "2026-10-23T16:05:00Z"
}
```

Previous: [List job submissions](https://cotlet.dev/docs/api/bullhorn/list_job_submissions.md)
Next: [Submit candidates to a job](https://cotlet.dev/docs/api/bullhorn/add_submission.md)

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [Use cases](https://cotlet.dev/use-cases.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.