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