Add candidates to hotlist

Put candidates into a hotlist.

POST https://cotlet.dev/api/v1/jobdiva/hotlists/{hotlist_id}/candidates-to-hotlists

write

Adds the candidates in one call and returns how many are in the hotlist now. Reaches no one and is undone with remove_candidates_from_hotlist, so it does not wait for your OK.

Parameters

Parameters: add_candidates_to_hotlist
NameTypeDescription
hotlist_id integer required integer Hotlist ID from list_hotlists or create_hotlist.
candidate_ids integer[] required integer[] Candidate IDs to add.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/jobdiva/hotlists/88314/candidates-to-hotlists \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"candidate_ids":[5821904,5830117,5834402]}'
Python
result = client.call("jobdiva", "add_candidates_to_hotlist", {"hotlist_id":88314,"candidate_ids":[5821904,5830117,5834402]})
Node.js
const result = await cotlet.call('jobdiva', 'add_candidates_to_hotlist', {"hotlist_id":88314,"candidate_ids":[5821904,5830117,5834402]});
CLI
cotlet call jobdiva add_candidates_to_hotlist --data '{"hotlist_id":88314,"candidate_ids":[5821904,5830117,5834402]}'

Example response

JSON

{
  "hotlist_id": 88314,
  "added": 3,
  "hotlist_size": 3
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.