Vincere Connector

Embed candidate, contact, job and placement automations from Vincere directly inside your product. Build tenant-aware workflows that list and sync new candidates, write placements and surface Vincere custom fields without heavy backend work.

Build with this Connector Talk to an integration expert

Ship integrations faster

Low-code flows reduce engineering time and custom code.

Tenant-aware orchestration

Reuse workflows while isolating per-customer credentials and data.

Governed MCP actions

Publish controlled Vincere actions for power users and admins.

Embedded experience

Deliver customer-facing workflows natively inside your SaaS product.

CONNECTOR OVERVIEW

Overview

Teams can integrate and automate Vincere candidate, contact, company, job and placement workflows — listing new candidates, reading custom fields and creating or updating records. Use Cyclr to build low-code, tenant-aware automations that sync Vincere data into your app and trigger placement notifications. See Vincere’s developer portal for API specifics (Vincere API developer portal). (api-portal.vincere.io)

PRODUCT USE CASES

Top Use Cases for Vincere Integrations

Practical, tenant-aware automations for recruiting products: sync candidate and job data, keep contacts and companies current, automate placement or offer status updates, and expose controlled Vincere actions to power users.

Auto-sync new candidates into your product

List new Candidate records from Vincere and create or update matching candidate records in your application (List New Candidate Records, Create/Update Candidate). (community.cyclr.com)

Keep contacts and companies in sync

Mirror Vincere Contact and Company updates into your CRM surfaces to keep client records consistent across tenant accounts.

Trigger placement and offer notifications

Watch Placement and Job status changes and trigger in-app notifications, emails or downstream workflows when offers progress.

ORCHESTRATION

How Vincere works with Cyclr

Cyclr sits between your SaaS product and Vincere to handle authentication, govern access and orchestrate every API call per customer, at scale.

1
Your SaaS product
Your app requests an action for a specific customer.
2
Cyclr orchestration
Cyclr authenticates, applies policies and routes the request.
3
Vincere
Vincere processes the request and returns a response to your app.

Customer-specific authentication · Governed data movement · Centralized visibility and audit

CONNECTOR COVERAGE

Available connector capabilities

Explore Vincere methods you can orchestrate through Cyclr.

Companies21

Create Company

Action

Create a New Company.

List Company Industries

Action

List company's industries.

Update Company

Action

Update the specified company.

Link Company Industy

Action

Link one or more company industries.

List Company Subindustries

Action

List company's subindustries.

Get Company By Name

Action

Get a company by name.

Get Company

Action

Get the details of the specified Company.

List Updated Companies

Action

Return a list of Company records updated since the last run date.

Search Companies

Action

Return a list of Company records matched with the search criteria.

List Company Brands

Action

Lists a company's brands.

Link Company Subindustries

Action

Link one or more company subindustries.

Get Company By ID

Action

Search a company by ID.

List Companies

Action

Return a list of all Company records

Update Company Location

Action

Update an existing company location.

Delete Company Location

Action

Delete the specified location by Location ID.

Upsert Company Custom Fields

Action

Create or update custom fields of the specified company.

Create Company Location

Action

Create a new location for a company, specified by company ID.

List Company Custom Fields

Action

Lists all custom fields on the company object.

List Custom Fields By Company

Action

Lists the custom fields for the specified company.

Get Company Location

Action

Retrieve details of the specified company location by Location ID.

List Company Locations

Action

Retrieve a list of locations for the specified company.

Applications7

Reject Application

Action

Currently, only possible to reject application in stage shortlisted or sent or in stage interviewing but does not have an on-going interview.

Search Job Applications

Action

List the Applications associate with a Job.

List Active Applications by Candidate

Action

List the list of active applications by candidate ID.

Get Application

Action

Get details of the specified application

List Job Applications

Action

List the Applications associate with a Job.

List Application Substatus

Action

Lists all sub-status details for applications

Add Application

Action

Applications, otherwise known as Job submissions, Job status, Job objects or Job actions. Applications associate Candidates with Jobs. Candidate applications always have exactly 1 job.

Statuses1

List Job Statuses

Action

List all job statuses.

Candidates23

Update Candidate

Action

Update a Candidate.

Get Candidate

Action

Get a Candidate by ID.

Get Candidate V2

Action

Get the specified candidate along with any additionaly added response fields.

Create Candidate

Action

Create a Candidate.

List Candidate Brands

Action

Lists a candidates brands.

List Candidate Records

Action

Return a list of candidate records matched with the search criteria.

List Updated Candidate Records Incrementally

Action

Return a list of updated candidate records matched with the search criteria since the last run time.

List New Candidate Records

Action

Return a list of candidate records matched with the search criteria since the last run time.

Delete Candidate

Action

Delete a Candidate by ID.

Link Functional Expertise to Candidate

Action

Link functional expertise IDs with a candidate by ID.

Get Candidate By Email

Action

Get a candidate by email.

List Candidate Desired Job Types

Action

Return all desired job types of a candidate.

Search Candidates

Action

Search candidate records with the specified query.

List Updated Candidate Records

Action

Return a list of updated candidate records matched with the search criteria since the last run time.

List Candidate Owners

Action

Return a list of all candidate owners for a given candidate.

Get Candidate Source Contact

Action

Get the source contact of the specified candidate.

Get Candidate Placement Status

Action

Get the placement status of the specified candidate.

List Candidate Applications

Action

Return a candidate applications.

Upsert Candidate Personal Location

Action

Create or update personal location of the candidate.

List Candidate Custom Fields

Action

Lists all custom fields on the candidate object.

Upsert Candidate Current Location

Action

Create or update current location of the candidate.

Upsert Candidate Custom Fields

Action

Creates or updates a Candidates custom field values.

List Candidate Custom Fields By Candidate

Action

Lists custom fields of the specified candidate.

Jobs14

List Job's Owners

Action

List all owners of a Job.

Get Job

Action

Get a Job by ID.

List Job Statuses

Action

Return a list of Job statuses.

Update Position Status

Action

Update the status of a Position.

List Job Brands

Action

Return a list of Job's brands.

Update Job

Action

Update an existing Job.

Upsert Job Custom Fields

Action

Creates or updates a Job custom field values.

List Jobs

Action

Return a list of Job records.

List Job Functional Expertises

Action

Returns a list of Job's functional expertises.

List Job Subfunctional Expertises

Action

Returns a list of Job's subfunctional expertises.

Search Jobs

Action

Return Jobs based on query (See Vincere API documentation)

List Updated Jobs

Action

Return a list of Jobs updated since last run.

List All Job Custom Fields

Action

Lists all custom fields on the job object.

List Custom Fields of Job

Action

Lists custom fields of the specified job.

Distribution List4

List Contacts By Distribution List

Action

List of contact details by a distribution list and user

Update Distribution List

Action

Update List of Distribution List of a Contact based on User's Permission.

Get Distribution List - Add Contacts

Action

Get Distribution Lists a User can use to add Contacts to.

Get Distribution List - User Permission

Action

Get Distribution Lists of a Contact based on User's Permission.

Webhooks (Beta)2

Contact Added (Distribution Lists)

Webhook

Triggers when a contact is added to a distribution list.

Candidate Added (Talent Pools)

Webhook

Triggers when a candidate is added to a talent pool.

Contacts22

List New Contact Records

Action

Return a list of new contact records matched with the search criteria since last run time.

Search Contact by Email

Action

Get a Contact by email, this method returns all the fields for a contact.

List Contact Work Locations

Action

Returns all of the contacts work locations.

Get Contact

Action

Get a Contact by ID.

Delete Contact

Action

Delete a Contact.

List Updated Contact Records

Action

Return a list of updated contact records matched with the search criteria since the last run time.

Upsert Contact Personal Location

Action

Creates or Updates a Contact Personal Location.

Search Contact by ID

Action

Get a Contact by ID, this method returns all the fields for a contact.

List Contact Records

Action

Return a list of contact records matched with the search criteria.

Get Personal Location

Action

Get the Personal Location of a Contact.

List Contact Brands

Action

Lists a contacts brands.

Add Contact Brand

Action

Add a brand to a contact.

Link Functional Expertise to Contact

Action

Link functional expertise IDs with a contact by ID.

Update Contact

Action

Update a Contact.

Create Contact

Action

Create a New Contact.

Search Contacts

Action

Search candidate records with the specified query.

List Contact Jobs

Action

Lists a contacts Jobs.

List Updated Contact Records Incrementally

Action

Return a list of updated contact records matched with the search criteria since the last run time incrementally.

Get Contact V2

Action

Get the specified contact along with any additionaly added response fields.

List Contact Custom Fields

Action

Lists all custom fields on the contact object.

Get Contacts Custom Fields

Action

List a Contacts custom fields by ID.

Upsert Contact Custom Fields

Action

Creates or updates contact custom fields.

Users7

List Users

Action

Get a List of All Users.

Get Current User

Action

Get the currently authenticated user.

Get User

Action

Get a user for a given ID.

Search Users

Action

Returns a list of users based on query.

List Divisions By User

Action

List all divisions by user ID.

List Users By Division

Action

List all users by division ID.

List Divisions

Action

List all divisions.

Activities3

Search Activities

Action

Search all activities using the specified filters.

Search New Activities

Action

Search specified activities created since last run.

Create Task

Action

Create a task activity.

Talent Pools4

List Candidates By Talent Pool

Action

List candidate details by a talent pool and user

Update Candidate Talent Pools

Action

Update list of talent pools of a candidate based on user's permission

Get Accessible Talent Pools

Action

Get talent pools a user can use to add candidates to.

Get Candidate Talent Pool

Action

Get talent pools of a candidate based on user's permission

Webhooks2

List Webhooks

Action

List all webhooks.

List DLQ Messages

Action

Returns the messages in the dead letter queue.

Branches3

List Contact Branches

Action

List the branches for the specified contact.

List Company Branches

Action

List the branches for the specified company.

List Candidate Branches

Action

List the branches for the specified candidate.

Internal3

Upsert Contact Custom Fields (Beta)

Action

Creates or updates contact custom fields.

Search Candidate by ID (no fields)

Action

Get a Candidate by ID

Search Contact by ID (no fields)

Action

Get a Contact by ID

Placements1

Get Placement

Action

Gets the specified placement.

Sources3

Get Contact Source

Action

Get a Contact Source by its Source ID.

List Candidate Sources

Action

Get a List of All Candidate Sources.

List Contact Sources

Action

Get a List of All Contact Sources.

Meetings3

List Meeting's Linked Contacts

Action

List all contacts linked to a meeting.

List Meeting's Linked Candidates

Action

List all candidates linked to a meeting.

List Meetings (Date Range)

Action

List meetings between a date range.

Email Subscriptions1

Update Email Subscription Status

Action

Update the status of an email subscription.

Reference lists1

Reference list for Contact Stages

Action

Lists the available contact stages

TECHNICAL DETAILS

Vincere integration and API details

Review the sourced authentication and API behaviour used when configuring customer-facing Vincere integrations in Cyclr.

API and authentication

API host: https://{yourdomain}.vincere.io
Authentication: API key; OAuth 2.0
Credentials: Client ID; Secret (leave blank per Cyclr); Domain (subdomain); API Key.
Method categories: List; Get; Create; Update; Custom-field management; Search

View vendor API documentation →

Pagination and rate limits

Pagination

List endpoints return arrays under an ‘items’ parent; Cyclr list methods need the correct parent path (for example ‘[items].’). (community.cyclr.com)

Rate limits

Refer to the vendor API documentation for current limits.

IMPLEMENTATION

Authentication at a glance

Vincere issues tenant API keys and supports an OAuth 2.0 flow (Auth0). Cyclr uses Client ID plus the tenant API Key during installation. Confirm available options in Console. (help.vincere.io)

Authentication method: API key; OAuth 2.0
Credential required: Client ID; Secret (leave blank per Cyclr); Domain (subdomain); API Key.

Before you begin:

Partner API keys require Vincere approval and a correct Auth0 Callback URL. (help.vincere.io)

View setup guide

COMMON QUESTIONS

Frequently asked questions

It can sync and manipulate core Vincere records — candidates, contacts, companies, jobs and placements — including listing new candidates, reading custom fields and creating or updating records. Cyclr maps those API operations into low-code workflow steps. (community.cyclr.com)

Vincere uses tenant-issued API keys plus an OAuth 2.0 (Auth0) flow; Cyclr installations require a Client ID and the tenant API Key. API key issuance and callback URL setup are managed through Vincere’s Marketplace/API settings. (help.vincere.io)

Yes. Cyclr supports tenant-specific credentials and subdomain configuration so each customer uses their own Vincere tenant and API key, keeping data and auth isolated. (community.cyclr.com)

Yes. You can surface curated Vincere actions (for example Create Candidate or Search Candidates) as governed MCP tools with Cyclr to control who can run them and capture audit trails.

KEEP EXPLORING

Related resources and connectors

Documentation

Vincere Connector

Ship integrations faster

Tenant-aware orchestration

Governed MCP actions

Embedded experience

Overview

Top Use Cases for Vincere Integrations

Auto-sync new candidates into your product

Keep contacts and companies in sync

Trigger placement and offer notifications

How Vincere works with Cyclr

Your SaaS product

Cyclr orchestration

Vincere

Available connector capabilities

Create Company

List Company Industries

Update Company

Link Company Industy

List Company Subindustries

Get Company By Name

Get Company

List Updated Companies

Search Companies

List Company Brands

Link Company Subindustries

Get Company By ID

List Companies

Update Company Location

Delete Company Location

Upsert Company Custom Fields

Create Company Location

List Company Custom Fields

List Custom Fields By Company

Get Company Location

List Company Locations

Reject Application

Search Job Applications

List Active Applications by Candidate

Get Application

List Job Applications

List Application Substatus

Add Application

List Job Statuses

Update Candidate

Get Candidate

Get Candidate V2

Create Candidate

List Candidate Brands

List Candidate Records

List Updated Candidate Records Incrementally

List New Candidate Records

Delete Candidate

Link Functional Expertise to Candidate

Get Candidate By Email

List Candidate Desired Job Types

Search Candidates

List Updated Candidate Records

List Candidate Owners

Get Candidate Source Contact

Get Candidate Placement Status

List Candidate Applications

Upsert Candidate Personal Location

List Candidate Custom Fields

Upsert Candidate Current Location

Upsert Candidate Custom Fields

List Candidate Custom Fields By Candidate

List Job's Owners

Get Job

List Job Statuses

Update Position Status

List Job Brands

Update Job

Upsert Job Custom Fields

List Jobs

List Job Functional Expertises

List Job Subfunctional Expertises

Search Jobs

List Updated Jobs

List All Job Custom Fields