JobDiva logo JobDiva automation · runs daily

Log call notes on JobDiva candidate records

After a day of screening calls, the notes sit in a notebook or a doc, and each one still has to be typed into the right candidate record.

Cotlet does it in your own JobDiva account with find_candidate, list_candidate_notes and add_candidate_note, called by your AI agent, an n8n workflow or a script.

Sign up free All JobDiva tools

Hosted · nothing to install or maintain

Can JobDiva do this on its own?

JobDiva's API can create, pin and delete candidate notes and can list note templates (checked 23 Oct 2026), but it needs a client ID from JobDiva. The app has no way to turn a text of call notes into notes on many records, and JobDiva has no MCP server.

How you do it in JobDiva today

  1. The recruiter finds the candidate by name, email or phone and opens the record.
  2. The recruiter adds a note, picks an action type and a date, and links the note to an open job or a contact when the call was about one.
  3. The note appears in the record's notes, where colleagues read the history before they call the same person.
  4. This repeats for every candidate on a busy day, so notes are the first thing to slip, and a missing note means the next recruiter calls cold.

How to log call notes on JobDiva candidate records

Prompt

Here are my call notes from today. For each candidate, find the record in JobDiva and add a note with the summary. Skip anyone who already has a note from today.
  1. 01

    Match each name to one record

    find_candidate looks up the name, email or phone from your notes. When two records match, for example the same name in two cities, the agent compares location and occupation with your notes and asks you instead of guessing.

  2. 02

    Check what is already there

    list_candidate_notes reads the notes on the record. If a note from today already carries the same call, the agent skips the candidate, so running the job twice never doubles a note.

  3. 03

    Pick the action type

    The agent copies the action type from the candidate's earlier notes for the same kind of call. Action types are set up in your account, so when none fits, the agent asks which one to use.

  4. 04

    Link the job when you named one

    add_candidate_note saves the summary as the note text and passes the job id when your notes name an open job. A note about a client contact is left unlinked, because the tool takes no contact link.

  5. 05

    Report what it saved

    The agent lists every candidate noted and every one it skipped, with the reason, so you can open any record and see the note.

What you get back

Example data

Calls in your notes: 6
Notes added 4 (Phone Call):
- Priya Raman: "Open to contract at 90 USD/h, free from 3 Nov"
- Marcus Lee: "Wants permanent, not relocating"
Skipped 1 (a note from today already exists)
Needs you 1: two records named Sam Ortiz

Other ways to ask

  • Log my call notes, link each note to job 24071835 and show me the list before you save anything.
  • Every evening, read my notes doc and add a note for each candidate I named.
  • Add a note to every candidate on this list saying the client closed the job.

What JobDiva allows, and what to know first

  • A JobDiva candidate note carries an action type and an action date, and can be linked to an open job or to a contact.
  • JobDiva keeps note templates for candidates, so a team can have standard wording for a call type.
  • JobDiva lets a user pin a candidate note, which keeps it on top of the notes list.
  • JobDiva's quick candidate search matches first name, last name, email, alternate email, work, home and cell phone, fax and address.

add_candidate_note changes only your own JobDiva data and reach no one else, so it runs without asking first.

Sources: JobDiva API (Swagger UI, Version 2) · JobDiva: Integrate with JobDiva

Call add_candidate_note from a script

curl

curl -X POST https://cotlet.dev/api/v1/jobdiva/candidates/5821904/note \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"note":"Open to contract at 90 USD/h, free from 3 Nov. Not relocating.","action":"Phone Call","job_id":24071835}'

Example response

{
  "note_id": 90214531,
  "candidate_id": 5821904,
  "action": "Phone Call",
  "job_id": 24071835,
  "status": "saved"
}

MCP: add https://cotlet.dev/mcp/v1 with the same key; the call is jobdiva_write → add_candidate_note. Example data.

Schedule it in n8n, Make, Zapier or cron

JobDiva tools this automation uses

Cotlet JobDiva tools used to log call notes on JobDiva candidate records
Tool Parameters
find_candidate value, limit
list_candidate_notes candidate_id
add_candidate_note candidate_id, note, action, job_id
All 14 JobDiva tools with descriptions

Frequently asked questions

Is it safe to connect JobDiva to Cotlet?

Yes. You sign in to JobDiva yourself, in your own Cloud Browser in the EU, and we never save your password. Your agents only get JobDiva once you enable it, every background request is listed, and the browser profile is stored encrypted with AES-256-GCM, the cipher 1Password uses for its vaults. The AI model never sees a login, posts and messages wait for your OK, and Disable for agents cuts access in one click. Independent scanners grade cotlet.dev A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory; live results are on https://cotlet.dev/security.

Give your agent access to JobDiva.

Free 7-day trial with 2,000 credits, no card needed. Cotlet is independent and not affiliated with JobDiva.

Sign up free