---
title: "Vincere OAuth Setup Guide for Unified"
img: https://s3.us-east-2.amazonaws.com/unified-article-images/vincere_oauth_setup_guide_for_unified-icon.png
date: 2026-11-09T00:00:00.000Z
updated: "2026-11-09T03:59:29.211Z"
tag: Guides
integrations: vincere
description: "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,..."
url: "https://docs.unified.to/guides/vincere_oauth_setup_guide_for_unified"
---

# 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:


```plain text
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.