feat(integrations): add support for hibob-oauth

docs/api-catalog.txt

@@ -2,7 +2,7 @@
 
 > Compact provider slug catalog for agents. Use the slug to reconstruct provider-specific docs URLs only when needed.
 
-Provider count: 950
+Provider count: 951
 
 URL patterns:
 - Main provider page: https://nango.dev/docs/integrations/all/{slug}.md or https://nango.dev/docs/api-integrations/{slug}.md
@@ -400,6 +400,7 @@ URL patterns:
 | `heygen` | HeyGen | OAUTH2 | [docs](https://nango.dev/docs/api-integrations/heygen.md) |  | [setup](https://nango.dev/docs/api-integrations/heygen/how-to-register-your-own-heygen-oauth-app.md) | video |
 | `heymarket` | Heymarket | JWT | [docs](https://nango.dev/docs/api-integrations/heymarket.md) | [connect](https://nango.dev/docs/api-integrations/heymarket/connect.md) |  | communication, marketing |
 | `heyreach` | HeyReach | API_KEY | [docs](https://nango.dev/docs/integrations/all/heyreach.md) | [connect](https://nango.dev/docs/integrations/all/heyreach/connect.md) |  | social, marketing |
+| `hibob-oauth` | HiBob (OAuth) | OAUTH2 | [docs](https://nango.dev/docs/api-integrations/hibob-oauth.md) |  | [setup](https://nango.dev/docs/api-integrations/hibob-oauth/how-to-register-your-own-hibob-oauth-app.md) | hr |
 | `hibob-service-user` | Hibob Service User | BASIC | [docs](https://nango.dev/docs/integrations/all/hibob-service-user.md) | [connect](https://nango.dev/docs/integrations/all/hibob-service-user/connect.md) |  | hr, popular |
 | `highlevel` | HighLevel | OAUTH2 | [docs](https://nango.dev/docs/api-integrations/highlevel.md) |  | [setup](https://nango.dev/docs/api-integrations/highlevel/how-to-register-your-own-highlevel-api-oauth-app.md) | marketing |
 | `highlevel-white-label` | HighLevel (LeadConnector) | OAUTH2 | [docs](https://nango.dev/docs/api-integrations/highlevel-white-label.md) |  | [setup](https://nango.dev/docs/api-integrations/highlevel-white-label/how-to-register-your-own-highlevel-white-label-api-oauth-app.md) | crm |

docs/api-integrations/hibob-oauth.mdx

@@ -0,0 +1,89 @@
+---
+title: 'HiBob (OAuth)'
+sidebarTitle: 'HiBob (OAuth)'
+description: 'Integrate your application with the HiBob API using OAuth 2.0'
+---
+
+<Note>
+OAuth 2.0 is available only for approved HiBob Marketplace and technology partners building apps that connect multiple customer tenants to Bob. If you're integrating your own single HiBob account, use [HiBob (Service User)](/integrations/all/hibob-service-user) instead.
+</Note>
+
+## 🚀 Quickstart
+
+Connect to HiBob with Nango and see data flow in 2 minutes.
+
+<Steps>
+    <Step title="Get a client ID and secret">
+    Follow the [setup guide](/api-integrations/hibob-oauth/how-to-register-your-own-hibob-oauth-app) below to get approved as a HiBob partner and register your app in the HiBob Developer Portal. You'll need the resulting **client ID** and **client secret** before you can create the integration in Nango.
+    </Step>
+    <Step title="Create the integration">
+    In Nango ([free signup](https://app.nango.dev)), go to [Integrations](https://app.nango.dev/dev/integrations) -> _Configure New Integration_ -> _HiBob (OAuth)_, and enter your client ID and client secret.
+    </Step>
+    <Step title="Authorize HiBob">
+    Go to [Connections](https://app.nango.dev/dev/connections) -> _Add Test Connection_ -> _Authorize_, then log in to HiBob and consent to the scopes and audience for a test company. Later, your customers will do this themselves when they install your app from the Bob Marketplace.
+    </Step>
+    <Step title="Call the HiBob API">
+    Let's make your first request to the HiBob API. Replace the placeholders below with your [secret key](https://app.nango.dev/dev/environment-settings), [integration ID](https://app.nango.dev/dev/integrations), and [connection ID](https://app.nango.dev/dev/connections):
+    <Tabs>
+        <Tab title="cURL">
+
+            ```bash
+            curl "https://api.nango.dev/proxy/v1/company/named-lists" \
+              -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
+              -H "Provider-Config-Key: <INTEGRATION-ID>" \
+              -H "Connection-Id: <CONNECTION-ID>"
+            ```
+
+        </Tab>
+
+        <Tab title="Node">
+
+        Install Nango's backend SDK with `npm i @nangohq/node`. Then run:
+
+        ```typescript
+        import { Nango } from '@nangohq/node';
+
+        const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });
+
+        const res = await nango.get({
+            endpoint: '/v1/company/named-lists',
+            providerConfigKey: '<INTEGRATION-ID>',
+            connectionId: '<CONNECTION-ID>'
+        });
+
+        console.log(res.data);
+        ```
+        </Tab>
+    </Tabs>
+    Or fetch credentials with the [Node SDK](/reference/backend/backend-sdk/node#get-a-connection-with-credentials) or [API](/reference/backend/http-api/connection/get).
+
+    ✅ You're connected! Check the [Logs](https://app.nango.dev/dev/logs) tab in Nango to inspect requests.
+    </Step>
+
+    <Step title="Implement Nango in your app">
+        Follow our [quickstart](/getting-started/quickstart) to integrate Nango in your app.
+    </Step>
+</Steps>
+
+<Note>
+The API access your app has for a given connection depends on the scopes and audience the customer approved during installation — a request can return a partial result set or a 404 for an employee outside the approved audience, even with valid scopes. See HiBob's [developer documentation](https://apidocs.hibob.com) for details on scopes and people data access.
+</Note>
+
+## 📚 HiBob Integration Guides
+
+Nango maintained guides for common use cases.
+
+- [How to register your own HiBob (OAuth) app](/api-integrations/hibob-oauth/how-to-register-your-own-hibob-oauth-app)
+  Get approved as a HiBob partner, register your app, and obtain OAuth credentials to connect it to Nango
+
+Official docs: [HiBob API docs](https://apidocs.hibob.com)
+
+## 🧩 Pre-built syncs & actions for HiBob
+
+Enable them in your dashboard. [Extend and customize](/guides/functions/functions-guide) to fit your needs.
+
+import PreBuiltUseCases from "/snippets/generated/hibob-oauth/PreBuiltUseCases.mdx"
+
+<PreBuiltUseCases />
+
+---

docs/api-integrations/hibob-oauth/how-to-register-your-own-hibob-oauth-app.mdx

@@ -0,0 +1,37 @@
+---
+title: 'How to register your own HiBob (OAuth) app'
+sidebarTitle: 'HiBob (OAuth) Setup'
+description: 'Register an OAuth app with HiBob and connect it to Nango'
+---
+
+<Note>
+OAuth 2.0 app integrations are available only for approved HiBob Marketplace and technology partners building apps that connect multiple customer tenants to Bob. For a single customer's own integration, use [HiBob (Service User)](/integrations/all/hibob-service-user) instead — it doesn't require partner approval.
+</Note>
+
+This guide shows you how to register your own app with HiBob to obtain your OAuth credentials (client ID & secret). These are required to let your customers install your app from the Bob Marketplace and grant it access to their HiBob account.
+
+<Steps>
+  <Step id="get-partner-approved" title="Get approved as a HiBob partner">
+    Apply for the HiBob Marketplace partner program. HiBob will review your application before granting you access to the Developer Portal.
+  </Step>
+  <Step id="map-scopes-and-webhooks" title="Map the scopes and webhooks your app needs">
+    Identify the minimum set of permissions (scopes) your app requires, and the webhook events (if any) it needs to subscribe to.
+  </Step>
+  <Step id="create-app-in-developer-portal" title="Create your app in the Developer Portal">
+    In the HiBob Developer Portal, create a new app and provide:
+    - Your installation mode: select **Install from your landing page** (set on Basic information, in the Installing your app section)
+    - Your list of required scopes
+    - Your redirect URI: `https://api.nango.dev/oauth/callback`
+    - A Landing page URL (HTTPS)
+
+    HiBob will provide you with a **client ID**, **client secret**, and an **App installation URL for testing**.
+  </Step>
+  <Step id="configure-in-nango" title="Configure the integration in Nango">
+    In Nango, go to [Integrations](https://app.nango.dev/dev/integrations) -> _Configure New Integration_ -> _HiBob (OAuth)_, and enter the **client ID** and **client secret** you received.
+  </Step>
+  <Step id="quickstart-next" title="Next">
+    Follow the [_Quickstart_](/getting-started/quickstart) to connect your first test company.
+  </Step>
+</Steps>
+
+---

docs/docs.json

@@ -1334,6 +1334,7 @@
               "api-integrations/heygen",
               "api-integrations/heymarket",
               "integrations/all/heyreach",
+              "api-integrations/hibob-oauth",
               "integrations/all/hibob-service-user",
               "api-integrations/highlevel",
               "api-integrations/highlevel-white-label",

docs/llms-full.txt

@@ -15044,6 +15044,7 @@ Use these slugs to construct provider-specific docs URLs only when needed.
 | `heygen` | HeyGen | OAUTH2 | [docs](https://nango.dev/docs/api-integrations/heygen.md) |  | [setup](https://nango.dev/docs/api-integrations/heygen/how-to-register-your-own-heygen-oauth-app.md) | video |
 | `heymarket` | Heymarket | JWT | [docs](https://nango.dev/docs/api-integrations/heymarket.md) | [connect](https://nango.dev/docs/api-integrations/heymarket/connect.md) |  | communication, marketing |
 | `heyreach` | HeyReach | API_KEY | [docs](https://nango.dev/docs/integrations/all/heyreach.md) | [connect](https://nango.dev/docs/integrations/all/heyreach/connect.md) |  | social, marketing |
+| `hibob-oauth` | HiBob (OAuth) | OAUTH2 | [docs](https://nango.dev/docs/api-integrations/hibob-oauth.md) |  | [setup](https://nango.dev/docs/api-integrations/hibob-oauth/how-to-register-your-own-hibob-oauth-app.md) | hr |
 | `hibob-service-user` | Hibob Service User | BASIC | [docs](https://nango.dev/docs/integrations/all/hibob-service-user.md) | [connect](https://nango.dev/docs/integrations/all/hibob-service-user/connect.md) |  | hr, popular |
 | `highlevel` | HighLevel | OAUTH2 | [docs](https://nango.dev/docs/api-integrations/highlevel.md) |  | [setup](https://nango.dev/docs/api-integrations/highlevel/how-to-register-your-own-highlevel-api-oauth-app.md) | marketing |
 | `highlevel-white-label` | HighLevel (LeadConnector) | OAUTH2 | [docs](https://nango.dev/docs/api-integrations/highlevel-white-label.md) |  | [setup](https://nango.dev/docs/api-integrations/highlevel-white-label/how-to-register-your-own-highlevel-white-label-api-oauth-app.md) | crm |

docs/llms.txt

@@ -143,7 +143,7 @@ Use provider URLs by replacing `{slug}` with a slug from the API catalog:
 
 ## APIs and integrations
 
-- [API catalog](https://nango.dev/docs/api-catalog.txt): 950 provider slugs with canonical docs routes, auth modes, setup guides, and connect guides.
+- [API catalog](https://nango.dev/docs/api-catalog.txt): 951 provider slugs with canonical docs routes, auth modes, setup guides, and connect guides.
 - Provider-specific pages are intentionally not expanded here so core Nango guides remain easy for agents to find.
 
 ## Resources

docs/snippets/generated/hibob-oauth/PreBuiltUseCases.mdx

@@ -0,0 +1,3 @@
+_No pre-built syncs or actions available yet._
+
+<Tip>Not seeing the integration you need? [Build your own](https://nango.dev/docs/guides/functions/functions-guide) independently.</Tip>

packages/providers/providers.scopes.yaml

@@ -4459,6 +4459,36 @@ helpscout-mailbox: []
 # HeyGen OAuth2 uses Authorization Code Flow with PKCE. No granular scopes documented.
 heygen: []
 
+# source: HiBob Developer Portal > "Scopes mapping to endpoints" (partner-only page, no public URL)
+hibob-oauth:
+    - attendance:write
+    - company.metadata:read
+    - company.metadata:write
+    - documents:read
+    - documents:write
+    - employee_data.history:read
+    - employee_data.sensitive.history:read
+    - employee_data.sensitive:read
+    - employee_data.sensitive:write
+    - employee_data:read
+    - employee_data:write
+    - goals:read
+    - goals:write
+    - hiring:write
+    - job_catalog:read
+    - learning.integrations:write
+    - payrollhub.deductions:write
+    - payrollhub.employee_sync:write
+    - payrollhub.payroll:read
+    - projects:write
+    - reports:read
+    - tasks:write
+    - timeoff.sensitive:read
+    - timeoff:read
+    - timeoff:write
+    - workforce_planning:read
+    - workforce_planning:write
+
 # source: https://marketplace.gohighlevel.com/docs/Authorization/Scopes
 highlevel:
     - adPublishing.readOnly

packages/providers/providers.yaml

@@ -10688,6 +10688,25 @@ hibob-service-user:
     docs: https://nango.dev/docs/integrations/all/hibob-service-user
     docs_connect: https://nango.dev/docs/integrations/all/hibob-service-user/connect
 
+hibob-oauth:
+    display_name: HiBob (OAuth)
+    categories:
+        - hr
+    auth_mode: OAUTH2
+    authorization_url: https://auth.app.hibob.com/oauth2/v1/apps/authorize
+    token_url: https://auth.app.hibob.com/oauth2/v1/apps/token
+    token_request_auth_method: basic
+    authorization_params:
+        response_type: code
+    token_params:
+        grant_type: authorization_code
+    refresh_params:
+        grant_type: refresh_token
+    scope_separator: ' '
+    proxy:
+        base_url: https://api.hibob.com
+    docs: https://nango.dev/docs/api-integrations/hibob-oauth
+
 heygen:
     display_name: HeyGen
     categories: