Skip to main content
Account management is only available with an institutional API key. Doctor-level API keys do not have access to these endpoints.
Institutional API keys can create and retrieve doctor accounts within their organization. Each account represents a clinician who can use the Telepatia scribe through your integration.

​
Creating an account

curl -X POST https://synapse.telepatia.ai/v1/institutional/accounts \
  -H "Authorization: Bearer YOUR_INSTITUTIONAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Dr. Jane Smith",
    "email": "jane.smith@clinic.com",
    "institutionalId": "DOCTOR-001"
  }'
Response: 
{
  "accountId": "acc_a1b2c3d4e5f6g7h8",
  "name": "Dr. Jane Smith",
  "email": "jane.smith@clinic.com",
  "institutionalId": "DOCTOR-001",
  "createdAt": "2026-02-20T10:00:00Z"
}
Save the accountId — you can use it to retrieve the account later.

​
Retrieving an account

curl https://synapse.telepatia.ai/v1/institutional/accounts/acc_a1b2c3d4e5f6g7h8 \
  -H "Authorization: Bearer YOUR_INSTITUTIONAL_API_KEY"
Response: 
{
  "accountId": "acc_a1b2c3d4e5f6g7h8",
  "name": "Dr. Jane Smith",
  "email": "jane.smith@clinic.com",
  "institutionalId": "DOCTOR-001",
  "createdAt": "2026-02-20T10:00:00Z"
}