feat(integrations): add support for humaans-io

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: 874
+Provider count: 875
 
 URL patterns:
 - Main provider page: https://nango.dev/docs/integrations/all/{slug}.md or https://nango.dev/docs/api-integrations/{slug}.md
@@ -385,6 +385,7 @@ URL patterns:
 | `hover` | Hover | OAUTH2 | [docs](https://nango.dev/docs/integrations/all/hover.md) |  |  | productivity |
 | `hubspot` | HubSpot | OAUTH2 | [docs](https://nango.dev/docs/api-integrations/hubspot.md) |  | [setup](https://nango.dev/docs/api-integrations/hubspot/how-to-register-your-own-hubspot-api-oauth-app.md) | marketing, support, crm, popular |
 | `hubspot-mcp` | HubSpot (MCP) | MCP_OAUTH2 | [docs](https://nango.dev/docs/api-integrations/hubspot-mcp.md) |  | [setup](https://nango.dev/docs/api-integrations/hubspot-mcp/how-to-register-your-own-hubspot-mcp-api-oauth-app.md) | marketing, support, crm, mcp |
+| `humaans-io` | Humaans.io | API_KEY | [docs](https://nango.dev/docs/api-integrations/humaans-io.md) | [connect](https://nango.dev/docs/api-integrations/humaans-io/connect.md) |  | hr |
 | `huntress` | Huntress | BASIC | [docs](https://nango.dev/docs/api-integrations/huntress.md) | [connect](https://nango.dev/docs/api-integrations/huntress/connect.md) |  | other |
 | `icypeas` | Icypeas | API_KEY | [docs](https://nango.dev/docs/integrations/all/icypeas.md) | [connect](https://nango.dev/docs/integrations/all/icypeas/connect.md) |  | marketing, crm |
 | `immybot` | ImmyBot | OAUTH2_CC | [docs](https://nango.dev/docs/api-integrations/immybot.md) | [connect](https://nango.dev/docs/api-integrations/immybot/connect.md) |  | dev-tools, support |

docs/api-integrations/humaans-io.mdx

@@ -0,0 +1,81 @@
+---
+title: 'Humaans.io'
+sidebarTitle: 'Humaans.io'
+description: 'Integrate your application with the Humaans.io API'
+---
+
+## 🚀 Quickstart
+
+Connect to Humaans.io with Nango and see data flow in 2 minutes.
+
+<Steps>
+    <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_ -> _Humaans.io_.
+    </Step>
+    <Step title="Authorize Humaans.io">
+    Go to [Connections](https://app.nango.dev/dev/connections) -> _Add Test Connection_ -> _Authorize_, then enter your Humaans.io API access token. Later, you'll let your users do the same directly from your app.
+    </Step>
+    <Step title="Call the Humaans.io API">
+    Let's make your first request to the Humaans.io API (get the authenticated user's profile, but requires the `private.read` or `public.read` scopes). 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/me" \
+              -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: '/me',
+            providerConfigKey: '<INTEGRATION-ID>',
+            connectionId: '<CONNECTION-ID>'
+        });
+
+        console.log(res.data);
+        ```
+        </Tab>
+
+    </Tabs>
+    Or fetch credentials with the [Node SDK](/reference/sdks/node#get-a-connection-with-credentials) or [API](/reference/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 [Auth implementation guide](/guides/primitives/auth) to integrate Nango in your app.
+
+        To obtain your own production credentials, follow the setup guide linked below.
+    </Step>
+</Steps>
+
+## 📚 Humaans.io Integration Guides
+
+Nango-maintained guides for common use cases.
+
+- [How do I link my Humaans.io account?](/api-integrations/humaans-io/connect)
+  Connect your Humaans.io account using the Connect UI
+
+Official docs: [Humaans.io API docs](https://docs.humaans.io/api/)
+
+## 🧩 Pre-built syncs & actions for Humaans.io
+
+Enable them in your dashboard. Extend and customize to fit your needs.
+
+import PreBuiltUseCases from "/snippets/generated/humaans-io/PreBuiltUseCases.mdx"
+
+<PreBuiltUseCases />
+
+---

docs/api-integrations/humaans-io/connect.mdx

@@ -0,0 +1,39 @@
+---
+title: Humaans.io - How do I link my account?
+sidebarTitle: Humaans.io
+---
+
+# Overview
+
+To authenticate with Humaans.io, you will need:
+1. **API Access Token** - A token that grants secure access to the Humaans.io API, scoped to the permissions you select when creating it.
+
+This guide will walk you through generating your **API Access Token** in Humaans.io.
+
+### Prerequisites:
+
+- You must have a Humaans.io account with a role that can create API access tokens (Owner, Admin, Finance, or Tech).
+
+### Instructions:
+
+#### Step 1: Generating your API access token
+
+1. Log in to your Humaans.io account.
+2. Click the arrows next to your name in the top left corner, then click **API access tokens**.
+3. Click **Generate new token**.
+4. Enter a name for your token, then select the [scopes](https://docs.humaans.io/api/#scopes) it needs (e.g. `public:read`, `private:read`, `private:write`, `compensations:read`, `compensations:write`, `documents:read`, `documents:write`, `webhooks:manage`).
+5. Click the **Click to copy** button next to your new token to copy it. Humaans.io only shows the token once, so store it securely.
+
+<Note>
+  The token inherits the permissions of the role of the user who created it, in addition to the selected scopes. For example, a token created by a `user` role can only ever access that user's own profile, even with `private:read` selected.
+</Note>
+
+#### Step 2: Enter credentials in the Connect UI
+
+Once you have your **API Access Token**:
+
+1. Open the form where you need to authenticate with Humaans.io.
+2. Enter your **API Access Token** in the field provided.
+3. Submit the form, and you should be successfully authenticated.
+
+You are now connected to Humaans.io.

docs/docs.json

@@ -1280,6 +1280,7 @@
               "api-integrations/highlevel-white-label",
               "integrations/all/holded",
               "integrations/all/hover",
+              "api-integrations/humaans-io",
               "api-integrations/huntress",
               "api-integrations/hubspot",
               "api-integrations/hubspot-mcp",

docs/llms-full.txt

@@ -14287,6 +14287,7 @@ Use these slugs to construct provider-specific docs URLs only when needed.
 | `hover` | Hover | OAUTH2 | [docs](https://nango.dev/docs/integrations/all/hover.md) |  |  | productivity |
 | `hubspot` | HubSpot | OAUTH2 | [docs](https://nango.dev/docs/api-integrations/hubspot.md) |  | [setup](https://nango.dev/docs/api-integrations/hubspot/how-to-register-your-own-hubspot-api-oauth-app.md) | marketing, support, crm, popular |
 | `hubspot-mcp` | HubSpot (MCP) | MCP_OAUTH2 | [docs](https://nango.dev/docs/api-integrations/hubspot-mcp.md) |  | [setup](https://nango.dev/docs/api-integrations/hubspot-mcp/how-to-register-your-own-hubspot-mcp-api-oauth-app.md) | marketing, support, crm, mcp |
+| `humaans-io` | Humaans.io | API_KEY | [docs](https://nango.dev/docs/api-integrations/humaans-io.md) | [connect](https://nango.dev/docs/api-integrations/humaans-io/connect.md) |  | hr |
 | `huntress` | Huntress | BASIC | [docs](https://nango.dev/docs/api-integrations/huntress.md) | [connect](https://nango.dev/docs/api-integrations/huntress/connect.md) |  | other |
 | `icypeas` | Icypeas | API_KEY | [docs](https://nango.dev/docs/integrations/all/icypeas.md) | [connect](https://nango.dev/docs/integrations/all/icypeas/connect.md) |  | marketing, crm |
 | `immybot` | ImmyBot | OAUTH2_CC | [docs](https://nango.dev/docs/api-integrations/immybot.md) | [connect](https://nango.dev/docs/api-integrations/immybot/connect.md) |  | dev-tools, support |

docs/llms.txt

@@ -134,7 +134,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): 874 provider slugs with canonical docs routes, auth modes, setup guides, and connect guides.
+- [API catalog](https://nango.dev/docs/api-catalog.txt): 875 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/humaans-io/PreBuiltUseCases.mdx

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

packages/providers/providers.yaml

@@ -10082,6 +10082,26 @@ hover:
         base_url: https://api.hover.to
     docs: https://nango.dev/docs/integrations/all/hover
 
+humaans-io:
+    display_name: Humaans.io
+    categories:
+        - hr
+    auth_mode: API_KEY
+    proxy:
+        base_url: https://app.humaans.io/api
+        headers:
+            authorization: Bearer ${apiKey}
+    docs: https://nango.dev/docs/api-integrations/humaans-io
+    docs_connect: https://nango.dev/docs/api-integrations/humaans-io/connect
+    credentials:
+        apiKey:
+            type: string
+            title: API Access Token
+            description: The API access token for your Humaans.io account
+            secret: true
+            example: P9IAs9**********************9oVR
+            pattern: '^[A-Za-z0-9]{32}$'
+
 huntress:
     display_name: Huntress
     categories: