Get Notes
AI-generatedSummary
Retrieve notes associated with a specific candidate by their numeric Candidate ID, allowing selection of returned fields and limiting the number of notes fetched.
Inputs
- Authentication — Choose either User Credentials (Email & Password) or Enterprise Credentials (API Key) for authentication. Defaults to Enterprise Credentials.
- Enable Operations Log — Optionally emit an audit log for every write operation; default is false.
- Candidate ID (required) — The numeric ID of the candidate whose notes are to be retrieved.
- Fields to Return — Comma-separated list of Bullhorn fields to include in the returned notes data; defaults to id,firstName,lastName,email,status.
- Limit — Maximum number of note records to return (between 1 and 500), default is 20.
Output shape
a list of note records corresponding to the specified candidate
The operation returns found notes with the specified fields, respecting the limit parameter. If no notes are found, a 'No results found' output object is emitted. Optional third output for operations log appears if enabled.
Examples
Example 1: Fetch up to 10 notes for candidate ID 123, returning note id, action, comments, and dateAdded fields.
Set Authentication to Enterprise Credentials, Candidate ID to 123, Fields to Return to 'id,action,comments,dateAdded', and Limit to 10.