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

# Connect Netsapiens

`POST /netsapiens/connect`

Validate credentials against the PBX (token grant + queue read probe)
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
  - `oncall_queue_extension` string, nullable — Call queue extension whose membership tracks the on-call user, e.g. 4607

## Response `200`

Successful Response

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

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/openintake/apis/fastapi.md) · [All operations](https://skmtc.dev/openintake/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openintake/fastapi/revisions/4a81645b59f6/schema)