diff --git a/docs/api-catalog.txt b/docs/api-catalog.txt index c3e7078343..05a74ef257 100644 --- a/docs/api-catalog.txt +++ b/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: 881 +Provider count: 882 URL patterns: - Main provider page: https://nango.dev/docs/integrations/all/{slug}.md or https://nango.dev/docs/api-integrations/{slug}.md @@ -389,6 +389,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 | diff --git a/docs/api-integrations/humaans-io.mdx b/docs/api-integrations/humaans-io.mdx new file mode 100644 index 0000000000..9041ea4227 --- /dev/null +++ b/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. + + + + In Nango ([free signup](https://app.nango.dev)), go to [Integrations](https://app.nango.dev/dev/integrations) -> _Configure New Integration_ -> _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. + + + Let's make your first request to the Humaans.io API (get the authenticated user's profile, but requires the `public:read` or `private: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): + + + + ```bash + curl "https://api.nango.dev/proxy/me" \ + -H "Authorization: Bearer " \ + -H "Provider-Config-Key: " \ + -H "Connection-Id: " + ``` + + + + + + Install Nango's backend SDK with `npm i @nangohq/node`. Then run: + + ```typescript + import { Nango } from '@nangohq/node'; + + const nango = new Nango({ secretKey: '' }); + + const res = await nango.get({ + endpoint: '/me', + providerConfigKey: '', + connectionId: '' + }); + + console.log(res.data); + ``` + + + + 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. + + + + 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. + + + +## 📚 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" + + + +--- diff --git a/docs/api-integrations/humaans-io/connect.mdx b/docs/api-integrations/humaans-io/connect.mdx new file mode 100644 index 0000000000..bd49f982c7 --- /dev/null +++ b/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. + + + 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. + + +#### 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. diff --git a/docs/api-integrations/humaans-io/form.png b/docs/api-integrations/humaans-io/form.png new file mode 100644 index 0000000000..fdd0427c52 Binary files /dev/null and b/docs/api-integrations/humaans-io/form.png differ diff --git a/docs/docs.json b/docs/docs.json index 7225804c7d..3187797769 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -1289,6 +1289,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", diff --git a/docs/llms-full.txt b/docs/llms-full.txt index ff2950b0ac..f9439642ad 100644 --- a/docs/llms-full.txt +++ b/docs/llms-full.txt @@ -14682,6 +14682,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 | diff --git a/docs/llms.txt b/docs/llms.txt index 9a2e6a3aea..75998c2d8c 100644 --- a/docs/llms.txt +++ b/docs/llms.txt @@ -139,7 +139,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): 881 provider slugs with canonical docs routes, auth modes, setup guides, and connect guides. +- [API catalog](https://nango.dev/docs/api-catalog.txt): 882 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 diff --git a/docs/snippets/generated/humaans-io/PreBuiltUseCases.mdx b/docs/snippets/generated/humaans-io/PreBuiltUseCases.mdx new file mode 100644 index 0000000000..4c3a8de9e0 --- /dev/null +++ b/docs/snippets/generated/humaans-io/PreBuiltUseCases.mdx @@ -0,0 +1,3 @@ +_No pre-built syncs or actions available yet._ + +Not seeing the integration you need? [Build your own](/guides/functions/functions-guide) independently. diff --git a/packages/providers/providers.yaml b/packages/providers/providers.yaml index e3395a4c16..4fc23a5129 100644 --- a/packages/providers/providers.yaml +++ b/packages/providers/providers.yaml @@ -10201,6 +10201,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: diff --git a/packages/webapp/public/images/template-logos/humaans-io.svg b/packages/webapp/public/images/template-logos/humaans-io.svg new file mode 100644 index 0000000000..8719e374e9 --- /dev/null +++ b/packages/webapp/public/images/template-logos/humaans-io.svg @@ -0,0 +1,9 @@ + + + + + + + + +