Practice Better

Syncs a Practice Better account so clinicians can ask questions across their own caseload.

Shape: credential (OAuth2 client credentials — no consent screen, so it behaves like a key, not like a redirect). Provider id: practice_better.

This connector ingests PHI

Every other connector ingests content the customer published. This one ingests their patients' medical records. Clinical text is de-identified before it leaves the adapter and that step fails closed — if de-identification cannot run, nothing is ingested. Treat the resulting vector as protected health information for every downstream decision: who can query the assistant, what is logged, how long the vector lives.

Credentials

Field	Required	Notes
clientId	✅	API client id (an identifier, not a secret)
clientSecret	✅	Stored encrypted, never returned

An invalid secret and a missing API add-on on the Practice Better side produce different messages — the validation error is surfaced verbatim rather than flattened to "invalid credentials", because the fix differs.

Settings

Setting	Default	What it does
targetVectorId	—	The vector this connector ingests into (required)
resources	sessionNotes, protocols, formRequests	Which record types to sync
teamFor	me	me for your own caseload, all for the whole practice
consultantIds	—	Limit to specific consultants
ownerFiltering	off	Limit each practitioner to clients they authored notes for
excludeArchived	on	Skip archived notes and protocols
dailyRequestBudget	2000	Cap on API calls per day
autoSync / syncIntervalMinutes	on / 1440	Recurring sync

Available resources: sessionNotes, protocols, formRequests, clientRecords, journalEntries, labRequests, medicalHistory, dietLifestyle, measurements.

The daily budget is shared, and it is not ours

Practice Better allows 10,000 requests per day across every integration on the account — not per integration. The default budget of 2,000 leaves headroom for whatever else the practice runs. Raise it only if you know what else is spending, or a wide sync can exhaust the practice's quota for the day.

Connect

curl -X POST https://api.divinci.app/api/v1/connectors/practice_better/auth \
  -H "Authorization: Bearer $DIVINCI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "credentials": { "clientId": "…", "clientSecret": "…" },
        "providerSettings": {
          "targetVectorId": "<vectorId>",
          "resources": ["sessionNotes", "protocols"],
          "teamFor": "me",
          "autoSync": true,
          "syncIntervalMinutes": 1440
        }
      }'

Credentials and settings go in one call deliberately: connecting first and configuring second leaves a half-configured connector behind whenever the second call never happens.

From the CLI

divinci connectors status practice_better
divinci connectors settings practice_better --auto-sync on --cadence 1440
divinci connectors sync-status <connectionId>
divinci connectors disconnect practice_better

See also

• De-Identification (PII)
• Managing connections