---
title: "Correct WelcomeKit Scopes for Jungle Integration"
img: https://s3.us-east-2.amazonaws.com/unified-article-images/correct_welcomekit_scopes_for_jungle_integration-icon.png
date: 2026-04-14T14:32:00.000Z
tag: Guides
description: "This guide outlines the required WelcomeKit scopes per Unified object for the Jungle integration."
url: "https://docs.unified.to/guides/correct_welcomekit_scopes_for_jungle_integration"
---

# Correct WelcomeKit Scopes for Jungle Integration
------
_April 14, 2026_

This guide outlines the required WelcomeKit scopes per Unified object for the Jungle integration.


## Scope Mapping (by Unified Object)


| Unified Object                                | Required Scope(s)                                                                                                                       | Partnership (su_*) Needed? |
| --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- |
| **ATS · Job (**`ats_job`**)**             | `su_jobs_r`                                                                                                                             | Yes                        |
| **ATS · Candidate (**`ats_candidate`**)** | **Read:** `candidates_r` AND `my_candidates_r` <br> **Write:** `candidates_rw` AND `my_candidates_rw`                                       | No                         |
| **ATS · Document (**`ats_document`**)**   | **Read:** `documents_r` AND (`candidates_r` & `my_candidates_r`) <br> **Write:** `documents_rw` AND (`candidates_rw` & `my_candidates_rw`) | No                         |
| **ATS · Activity (**`ats_activity`**)**   | **Read:** `emails_r` AND (`candidates_r` & `my_candidates_r`) <br> **Write:** `comments_w` AND (`candidates_rw` & `my_candidates_rw`)      | No                         |
| **HRIS · Company (**`hris_company`**)**   | **Read:** `su_organizations_r`                                                                                                          | Yes                        |
| **HRIS · Location (**`hris_location`**)** | **Read:** `offices_r` <br> Write: `offices_rw`                                                                                              | No                         |
| **HRIS · Group (**`hris_group`**)**       | **Read:** `departments_r` & `departments_rw` <br> **Write:** `departments_rw`                                                               | No                         |
---


## Important Notes


### Partnership-only scopes

- `su_jobs_r` → Required for listing jobs
- `su_organizations_r` → Required for listing organizations

These require WelcomeKit partnership approval.


---


### Candidate-dependent scopes


The following always require candidate access:

- Documents → require candidate read/write scopes
- Emails → require candidate read scopes
- Comments → require candidate write scopes

---


## How to Get Partnership Access (Jungle / WelcomeKit)


To access partnership-only scopes (`su_*`), you will need to be approved by WelcomeKit.


### Steps:

1. **Reach out to WelcomeKit support or your account manager (**[https://help.welcometothejungle.com/en](https://help.welcometothejungle.com/en))
    - Request access to partnership scopes (`su_jobs_r`, `su_organizations_r`)
    - Clearly mention your use case (e.g. job syncing, org-level data access)
2. **Provide integration details**
    - Your application name
    - What data you intend to access
    - Whether access is read-only or includes write operations
3. **Explain your end-user flow**
    - How users connect their WelcomeKit account
    - Why elevated (partnership) access is required
4. **Await approval**
    - Once approved, the scopes will be enabled for your app
    - You can then include `su_*` scopes in your OAuth flow