---
title: "Connect Netsapiens"
method: POST
path: "/netsapiens/connect"
tags: ["NetSapiens"]
---

# Connect Netsapiens

`POST /netsapiens/connect`

## Request

- Base URL: `https://api.openintake.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openintake.ai/netsapiens/connect`
- Auth: none declared

Validate credentials against the PBX (token grant) and upsert the
customer's NetSapiens connection.

## Request body

- NetSapiensConnectRequest
  - `base_url` string, required: ns-api base URL, e.g. https://24735-hpbx.dashmanager.com/ns-api/
  - `client_id` string, required
  - `client_secret` string, required
  - `username` string, required
  - `password` string, required
  - `pbx_domain` string, required: PBX domain, e.g. brianjlevy.24735.service

## Response `200`

Successful Response

- NetSapiensStatus
  - `connected` boolean, required
  - `base_url` string, nullable
  - `pbx_domain` string, nullable
  - `status` string, nullable
  - `last_error_at` string, date-time, nullable
  - `last_error_msg` string, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-07** `5e9781b57ad0`: 5 warning
  - removed the request property `oncall_queue_extension`
  - removed the optional property `last_reconcile_at` from the response with the `200` status
  - removed the optional property `last_successful_reconcile_at` from the response with the `200` status
  - removed the optional property `oncall_queue_extension` from the response with the `200` status
  - …1 more

[Operation history](https://skmtc.dev/openintake/apis/openintake-api/changes/netsapiens/connect/post.md)

---

[API](https://skmtc.dev/openintake/apis/openintake-api.md) - [All operations](https://skmtc.dev/openintake/apis/openintake-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openintake/apis/openintake-api/revisions/de90a8dcbc07?raw)