hibob docs

docs-v2/integrations/all/hibob-service-user/connect.mdx

@@ -0,0 +1,52 @@
+---
+title: Hibob - How do I link my account?
+sidebarTitle: Hibob
+---
+
+
+# Overview
+
+To authenticate with Hibob, you need two key pieces of information:
+1. **Token** - A key that grants access to your application and configurations.
+2. **Service User ID** - A unique identifier for your application on Hibob.
+
+This guide will walk you through finding or creating those credentials within Hibob.
+
+
+### Prerequisites:
+
+- You must set up an account with Hibob.
+
+
+#### Step 1: Finding Your hiBob Service User ID
+1. Log into your admin Hibob account. From the left menu, please select `Settings` > `Integrations`.
+2. Select `Automation`. Click the `Service Users` icon.
+3. Please enter a unique name and a display name.
+
+
+<img src="/integrations/all/hibob-service-user/hibob_1.png" />
+
+
+4. After adding these mandatory fields please click `Save` and the service user’s `ID` and `token` will be displayed.
+5. Securely store the service user `ID`.
+
+#### Step 2: Finding Your hiBob token
+1. From the prevouse step, securley store your `token`.
+
+
+<img src="/integrations/all/hibob-service-user/hibob_2.png" />
+
+
+#### Step 3: Connect Your Hibob Account
+
+<img src="/integrations/all/hibob-service-user/nango_connect_ui.png" />
+
+To authenticate using your API credentials, navigate to the Hibob authentication form.
+Enter your credentials as follows:
+- Service User ID: Your hibob ID
+- Token: Your hibob Token
+Click "Connect" to complete the authentication.
+
+Note: Make sure to match the credentials exactly as shown above - the field names in the form may differ from your Hibob dashboard.
+
+`// TODO: update connect_ui image`

docs-v2/integrations/all/hibob.mdx

@@ -30,3 +30,7 @@ API configuration: [`hibob`](https://nango.dev/providers.yaml)
 - For Basic auth, HiBob uses ID as the username and token as the password.
 
 <Note>Add Getting Started links and Gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/hibob.mdx)</Note>
+
+<Card title="Connect to hibob" icon="link" href="/integrations/all/hibob-service-user/connect" horizontal>
+  Guide to connect to hibob API using Nango Connect.
+</Card>

packages/shared/providers.yaml

@@ -3169,7 +3169,19 @@ hibob-service-user:
         verification:
             method: GET
             endpoint: /v1/company/named-lists
+    credentials:
+        username:
+            type: string
+            title: Service User ID
+            description: The ID of the service user
+            doc_section: '#step-1-finding-your-hibob-service-user-id'
+        password:
+            type: string
+            title: Token
+            description: Token associated to service user
+            doc_section: '#step-2-finding-your-hibob-token'
     docs: https://docs.nango.dev/integrations/all/hibob
+    docs_connect: https://docs.nango.dev/integrations/all/hibob-service-user/connect
 
 highlevel:
     display_name: HighLevel