Actions87
- Appointment Actions
- Candidate Actions
- Company Actions
- Contact Actions
- File Actions
- Job Actions
- Job Submission Actions
- Lead Actions
- Note Actions
- Opportunity Actions
- Placement Actions
- Sendout Actions
- Task Actions
- Tearsheet Actions
Candidate → Create
AI-generatedSummary
Creates a new Candidate record in Bullhorn using field pairs or a JSON object payload.
Inputs
- authentication (required) — Authentication method: 'user' for Email & Password or 'enterprise' for API Key.
- enableOperationsLog — Whether to emit an audit log row to a second 'Operations Log' output for every write operation.
- inputMode (required) — How to build the payload: 'fields' for UI field pairs or '' for a pre-built JSON object.
- createData (required) — Bullhorn fields and values for the new record. TO_ONE references (e.g., clientCorporation=123) are auto-converted to {id: 123}.
- dataJson — JSON object of fields to write. Empty/null/undefined values are skipped. Numeric TO_ONE references are auto-wrapped as {id: 123}.
- outputFields — Fields to include in every output item, merged into results, no-results, and error items.
Output shape
A single record (the newly created Candidate).
The operation returns the created entity. If inputMode is 'fields', empty values are skipped; if '', null/undefined values are skipped. TO_ONE references are auto-wrapped as {id: ...}.
Examples
Example 1: Create a Candidate using field pairs
Set inputMode to 'fields' and populate createData with fieldName/value pairs. TO_ONE references like clientCorporation=123 are auto-converted.
Example 2: Create a Candidate using a JSON object
Set inputMode to '' and provide a dataJson object. Null/undefined values are skipped, and numeric IDs are auto-wrapped (e.g., {clientCorporation: 123} becomes {clientCorporation: {id: 123}}).