[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)

# Shortlist Vincere candidates for a job with AI

> Shortlist Vincere candidates from a talent pool to an open job by your own rule, skip people already on it and keep edge cases for yourself.

Source: https://cotlet.dev/integrations/vincere-api-mcp-server/shortlist-candidates-for-a-job

A new job opens, and a recruiter spends the morning opening profiles from a talent pool, deciding who fits, and ticking Shortlist on each one.

Cotlet does it in your own Vincere account with list\_jobs, get\_job, list\_candidates, get\_candidate, shortlist\_candidates and list\_job\_applications, called by your AI agent, an n8n workflow or a script.

[Sign up free](https://cotlet.dev/app/signup?app=vincere) [All Vincere tools](https://cotlet.dev/integrations/vincere-api-mcp-server.md)

Hosted · nothing to install or maintain

## Can Vincere do this on its own?

Vincere has no shortlist action in its Zapier app and issues API keys only to partners (checked 22 Oct 2026). Shortlisting is done by hand in the app, one table selection at a time, and nothing in Vincere shortlists by a rule on the candidate profile.

## How you do it in Vincere today

1. In Candidates table view, the recruiter ticks the candidates, then clicks Shortlist in the actions bar.
2. In the dialog the recruiter picks one or more jobs from the open-jobs list, using the filter icon and Jobs > My Jobs to cut the list, then clicks "Shortlist candidate(s) to Job(s)".
3. From a Candidate Quick View or a full profile, the same step is Actions (top right) > Shortlist.
4. Another way starts in the job profile: open the Pending Application stage and change the candidate's stage to Shortlisted.
5. To check the result, the recruiter opens the job profile and looks for the candidate in the Shortlisted stage, or for the tick marks Vincere shows.

## How to shortlist Vincere candidates for a job with AI

Prompt

```
For the open job "Senior Java Developer" in Vincere, find candidates in the Java talent pool, skip anyone already on that job, and shortlist the ones whose current title is a developer role. List the rest for me.
```

1. 01  
### Confirm the job can take people  
Your agent calls list\_jobs with status open, then get\_job for the one you named. It reads the Sourcing close date and stops if the date has passed, because Vincere does not offer a closed or full job in the shortlist dialog.
2. 02  
### Pull the pool, skip who is on the job  
list\_candidates returns the Talent Pool you name, page by page. The agent drops anyone list\_job\_applications already shows on this job, so a person is never added twice.
3. 03  
### Read each profile against your rule  
get\_candidate gives the current job title, company and applications of each remaining candidate. The agent applies the rule from your prompt, such as "current title is a developer role", and quotes the line it relied on.
4. 04  
### Shortlist the matches  
shortlist\_candidates runs once for the matches, in one call. It waits for your OK by default, and it sends nothing to the candidate or a client.
5. 05  
### Check it saved  
Vincere can show a confirmation while the association is not saved. The agent reads the Shortlisted stage again with list\_job\_applications and lists anyone who is missing.

### What you get back

Example data

```
Job: Senior Java Developer (Brightline Tech), open, sourcing closes 30 Nov
Candidates in the Java talent pool: 18
Already on the job: 5
Shortlisted 9, e.g. Priya Nair: "Java Developer, Northwind Systems"
Left for you 4:
- Tomas Wu: "Project Manager"
- Lena Ortiz: no job title on the profile
```

### Other ways to ask

- Every morning, shortlist new candidates added to the Java talent pool to my open Java jobs and list the rest for me.
- Show which of my open jobs have no shortlisted candidates yet, and shortlist nobody.
- Shortlist this one candidate to all my open jobs in London and tell me which jobs refused.

## What Vincere allows, and what to know first

- Vincere lets you shortlist candidates to open jobs only, and a job is missing from the dialog when it is closed, has no headcount left or its Sourcing closed date has passed.
- Vincere allows 1,000 total position associations per candidate, counting shortlisted, floated and applied positions, and past that cap shortlisting may fail silently with a confirmation on screen.
- Vincere lets you select up to 300 candidate records at once, so a larger pool has to be shortlisted in batches.
- Vincere's candidate and job management settings decide which candidates can move to Shortlisted, and restrictive settings grey out the checkboxes.
- Since Vincere v19.8, applications from Engage and Portals land in an Applications stage before Shortlisted, not in Shortlisted itself.

shortlist\_candidates asks for your OK by default. To run it daily without you, switch confirmation off for that tool in your dashboard.

Sources: [Vincere Help: Shortlist candidates to jobs](https://help.vincere.io/en/articles/5248683-shortlist-candidates-to-jobs) · [Vincere Help: Candidate Actions](https://help.vincere.io/en/articles/11143948-candidate-actions) · [Vincere Help: Moving candidates down the Pipeline](https://help.vincere.io/en/articles/2601266-moving-candidates-down-the-pipeline) · [Vincere Help: Platform updates v19.8](https://help.vincere.io/en/articles/8061669-vincere-platform-updates-v19-8-july-23)

## Call shortlist\_candidates from a script

curl

```
curl -X POST https://cotlet.dev/api/v1/vincere/jobs/1042/candidates/shortlist \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"candidate_ids":["88214","88230"]}'
```

Example response

```
{
"job_id": "1042",
"shortlisted": [
{
"candidate_id": "88214",
"name": "Priya Nair",
"stage": "shortlisted"
},
{
"candidate_id": "88230",
"name": "Tomas Wu",
"stage": "shortlisted"
}
],
"skipped": []
}
```

MCP: add https://cotlet.dev/mcp/v1 with the same key; the call is vincere\_write → shortlist\_candidates. Example data.

[Schedule it in n8n, Make, Zapier or cron](https://cotlet.dev/integrations/vincere-api-mcp-server.md#automations)

## Vincere tools this automation uses

__Cotlet Vincere tools used to shortlist Vincere candidates for a job with AI__
| Tool | Parameters |
| ----------------------- | ---------------------------------- |
| list\_jobs | status, query, limit, cursor |
| get\_job | job\_id |
| list\_candidates | talent\_pool, query, limit, cursor |
| get\_candidate | candidate\_id |
| shortlist\_candidates | job\_id, candidate\_ids |
| list\_job\_applications | job\_id, stage, limit, cursor |

[All 13 Vincere tools with descriptions](https://cotlet.dev/integrations/vincere-api-mcp-server.md#tools)

## Frequently asked questions

### Is it safe to connect Vincere to Cotlet?

Yes. You sign in to Vincere yourself, in your own Cloud Browser in the EU, and we never save your password. Your agents only get Vincere 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.

## More Vincere automations

- [Send a Vincere shortlist to a client as a LiveList](https://cotlet.dev/integrations/vincere-api-mcp-server/send-shortlist-to-client.md)
- [Log Vincere call notes and follow-up tasks with AI](https://cotlet.dev/integrations/vincere-api-mcp-server/log-calls-and-follow-up-tasks.md)
- [Vincere API and MCP server: every tool](https://cotlet.dev/integrations/vincere-api-mcp-server.md)
- [All use cases](https://cotlet.dev/use-cases.md)

## Give your agent access to Vincere.

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

[Sign up free](https://cotlet.dev/app/signup?app=vincere)

---

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 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.

## For AI agents: sign your user up

Is your user asking you to sign them up for Cotlet? You can do it for them, no account or key needed.

1. Read the fields and their allowed values: GET https://cotlet.dev/api/v1/access-requests
2. Ask the user for each value: email, apps, what you will do with them. If they leave the password to you, generate a strong one and show it to them.
3. Show the user what you will send, then POST it as JSON to https://cotlet.dev/api/v1/access-requests.

One call creates the account and sends the access request; we email the user when access is granted.