Vincere OAuth Setup Guide for Unified

November 9, 2026

Unified connects to Vincere using OAuth 2.0 plus an API key. Once connected, Unified can read and write Vincere data across the ATS (jobs, candidates, applications), CRM (companies, contacts), and HRIS (employees, locations) categories, including custom fields.

To connect Vincere in Unified, you need:

1. OAuth2 Client ID
2. API Key
3. Redirect URI — provided by Unified for your data region

Before you start

You will need:

• Admin access to Vincere (recommended), or
• A Vincere administrator who can:
  • Register an OAuth application
  • Generate an API key
  • Adjust user permissions

Your Vincere tenant URL looks like:

https://<yourdomain>.vincere.io

You don't need to enter it in Unified — Unified detects your tenant automatically when you log in.

Step 1: Register your application in Vincere

1. Log into your Vincere tenant as an administrator.
2. Open the API settings area and create a new application. If you don't see an option to create one, contact Vincere support to enable API access for your tenant.
3. Set the Redirect URI to exactly the value Unified provides (it must match exactly, including https://).
4. Save the application.
5. Copy the OAuth2 Client ID and API Key and store them securely.

Step 2: Connect Vincere in Unified

1. In Unified, go to Integrations and select Vincere.
2. Enter your OAuth2 Client ID and API Key.
3. Authorize a connection, then log into Vincere in the popup and approve access.

Once complete, the connection shows as Connected.

Step 3: Required Vincere permissions

Vincere uses role-based permissions, not API scopes. The Vincere user who logs in during the OAuth step must have access to the modules you want Unified to use.

The easiest option is to connect with an Administrator role. If you use a custom role, enable the following:

CRM (companies and contacts)

• CRM → Allow Access
• Company
• Contact

If CRM is disabled, Unified cannot access companies or contacts.

ATS (jobs, candidates, and applications)

• ATS → Allow Access
• Job — read and update jobs, access placements, view booked fees
• Candidate — access candidate records, edit CVs/resumes, update placements, talent pools
• Application Stages — move candidates through stages, shortlist, edit placements

If ATS is disabled, Unified cannot access jobs, candidates, or applications.

Step 4: Verify the connection

After connecting, make a test call (for example, list candidates or contacts) from the connection page in Unified or via the API. If the call returns data, you're done.

Troubleshooting

403 Forbidden

Check that the connecting user's role has:

• CRM enabled (for companies and contacts)
• ATS enabled, including Candidate and Job (for ATS data)
• No other restrictions on the modules you're calling

Permission changes can take up to 30 minutes to apply. If they don't apply right away, log out of Vincere and back in, then reauthorize the connection.

Rate limits

Vincere allows 10 requests per second and 50,000 requests per day per API key. Requests above this limit will be throttled.