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)

Write: candidates_rw AND my_candidates_rw | No | | ATS · Document (ats_document) | Read: documents_r AND (candidates_r & my_candidates_r) 

Write**:** documents_rw AND (candidates_rw & my_candidates_rw) | No | | ATS · Activity (ats_activity) | Read: emails_r AND (candidates_r & my_candidates_r) 

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  Write: offices_rw | No | | HRIS · Group (hris_group) | Read: departments_r & departments_rw

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