> ## Documentation Index
> Fetch the complete documentation index at: https://nango.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# NetSapiens

> Integrate your application with the NetSapiens API v2

## 🚀 Quickstart

Connect to NetSapiens with Nango and see data flow in 2 minutes.

<Note>
  NetSapiens is a multi-tenant UCaaS platform. Each service provider runs its own core, so every connection specifies the hostname of the core to call, plus the OAuth client and API user credentials issued by that provider.
</Note>

<Steps>
  <Step title="Create the integration" id="create-integration">
    In Nango ([free signup](https://app.nango.dev)), go to [Integrations](https://app.nango.dev/dev/integrations) -> *Configure New Integration* -> *NetSapiens*.
  </Step>

  <Step title="Authorize NetSapiens" id="authorize-netsapiens">
    Go to [Connections](https://app.nango.dev/dev/connections) -> *Add Test Connection* -> *Authorize*, then enter your NetSapiens server hostname, username, password, client ID, and client secret. Later, you'll let your users do the same directly from your app.
  </Step>

  <Step title="Call the NetSapiens API" id="call-netsapiens-api">
    Let's make your first request to the NetSapiens API to read the API version of the core. Replace the placeholders below with your [Environment API key](/docs/reference/backend/http-api/api-keys), [integration ID](https://app.nango.dev/dev/integrations), and [connection ID](https://app.nango.dev/dev/connections):

    <Tabs>
      <Tab title="cURL">
        ```bash theme={null}
        curl "https://api.nango.dev/proxy/v2/version" \
          -H "Authorization: Bearer <NANGO-API-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 theme={null}
        import { Nango } from '@nangohq/node';

        const nango = new Nango({ apiKey: '<NANGO-API-KEY>' });

        const res = await nango.get({
            endpoint: '/v2/version',
            providerConfigKey: '<INTEGRATION-ID>',
            connectionId: '<CONNECTION-ID>'
        });

        console.log(res.data);
        ```
      </Tab>
    </Tabs>

    Or fetch credentials with the [Node SDK](/docs/reference/backend/backend-sdk/node#get-a-connection-with-credentials) or [API](/docs/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" id="implement-nango">
    Follow our [quickstart](/docs/getting-started/quickstart) to integrate Nango in your app.
  </Step>
</Steps>

## 📚 NetSapiens integration guides

Nango maintained guides for common use cases.

* [How do I link my account?](/docs/api-integrations/netsapiens/connect)\
  Locate your NetSapiens server hostname and API credentials, then connect with the Connect UI

Official docs: [NetSapiens API v2 reference](https://docs.ns-api.com/v44.4/reference/post_tokens)

## 🧩 Pre-built syncs & actions for NetSapiens

Enable them in your dashboard. Extend and customize to fit your needs.

*No pre-built syncs or actions available yet.*

<Tip>Not seeing the integration you need? [Build your own](/docs/guides/functions/functions-guide) independently.</Tip>

## 💡 API gotchas

* The proxy base URL is `https://<server>/ns-api`. Include the API version in each endpoint path (for example `/v2/version` or `/v2/domains`).
* The API user's scope (Super User, Reseller, Office Manager, ...) determines which domains and resources the connection can read.
* The client ID and client secret are issued per platform by the service provider that operates the NetSapiens core; they cannot be self-registered.

***