Skip to content
Get started

Create and invite a new user

post/v1/autoScribe/users

Creates a new user in the AutoScribe system and sends them an invitation email. The user will have the specified permissions including report creation and study management capabilities. NPI number is required for users who can create reports.

Body ParametersExpand Collapse
canCreateReports: boolean
canManageStudies: boolean
clinicRole: "Radiologist" or "Cardiologist" or "Neurologist" or 18 more

User's clinical or organizational role

Accepts one of the following:
"Radiologist"
"Cardiologist"
"Neurologist"
"Urologist"
"Gynecologist"
"Endocrinologist"
"Doctor"
"Surgeon"
"Physician"
"Physician Assistant"
"Nurse Practitioner"
"Registered Nurse"
"Patient Care Coordinator"
"Front Desk Operator"
"Imaging Technologist"
"PACS Administrator"
"Software Engineer"
"Revenue Cycle Manager"
"Administrative Director"
"Administrative Assistant"
"Other"
email: string

User's email address for login and notifications

firstName: string

User's first name

minLength1
hasDashboardAccess: boolean
lastName: string

User's last name

minLength1
level: "admin" or "member"
Accepts one of the following:
"admin"
"member"
middleName: optional string

User's middle name (optional)

minLength1
npiNumber: optional string
minLength10
maxLength10
phoneNumber: optional string

User's phone number (10-15 digits, optional)

suffix1: optional string

Name suffix (e.g., 'Jr.', 'Sr.', 'III') - optional

minLength1
suffix2: optional string

Additional name suffix (optional)

minLength1
ReturnsExpand Collapse
canCreateReports: boolean

Whether the user can generate and sign radiology reports. Requires NPI number

canManageStudies: boolean

Whether the user has permission to create, update, and manage studies

clinicRole: "Radiologist" or "Cardiologist" or "Neurologist" or 18 more

User's clinical or organizational role

Accepts one of the following:
"Radiologist"
"Cardiologist"
"Neurologist"
"Urologist"
"Gynecologist"
"Endocrinologist"
"Doctor"
"Surgeon"
"Physician"
"Physician Assistant"
"Nurse Practitioner"
"Registered Nurse"
"Patient Care Coordinator"
"Front Desk Operator"
"Imaging Technologist"
"PACS Administrator"
"Software Engineer"
"Revenue Cycle Manager"
"Administrative Director"
"Administrative Assistant"
"Other"
createdAt: string

Timestamp when the user was created

formatdate-time
email: string

User's email address for login and notifications

firstName: string

User's first name

minLength1
hasDashboardAccess: boolean

Whether the user can access the dashboard interface. Required for admin users

invitedSource: "dashboard" or "api"

How the user was invited - via dashboard UI or API

Accepts one of the following:
"dashboard"
"api"
lastLoginAt: string

Timestamp of user's last login, null if never logged in

formatdate-time
lastName: string

User's last name

minLength1
level: "admin" or "member"

User access level. 'admin' can manage users/settings, 'member' has standard access

Accepts one of the following:
"admin"
"member"
userId: string

Unique user identifier. Format: usr_{32-hex-chars}

middleName: optional string

User's middle name (optional)

minLength1
npiNumber: optional string

National Provider Identifier - required for users who can create reports (10-digit number)

minLength10
maxLength10
phoneNumber: optional string

User's phone number (10-15 digits, optional)

suffix1: optional string

Name suffix (e.g., 'Jr.', 'Sr.', 'III') - optional

minLength1
suffix2: optional string

Additional name suffix (optional)

minLength1
Create and invite a new user
curl https://api.avarasoftware.com/v1/autoScribe/users \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $AVARA_API_KEY" \
    -d '{
          "canCreateReports": true,
          "canManageStudies": true,
          "clinicRole": "Radiologist",
          "email": "dr.johnson@hospital.org",
          "firstName": "Sarah",
          "hasDashboardAccess": true,
          "lastName": "Johnson",
          "level": "member",
          "middleName": "Marie",
          "npiNumber": "1234567893",
          "phoneNumber": "5551234567",
          "suffix1": "MD",
          "suffix2": "FACR"
        }'
{
  "canCreateReports": true,
  "canManageStudies": true,
  "clinicRole": "Radiologist",
  "createdAt": "2024-01-15T10:00:00Z",
  "email": "dr.johnson@hospital.org",
  "firstName": "Sarah",
  "hasDashboardAccess": true,
  "invitedSource": "api",
  "lastLoginAt": "2024-03-15T09:00:00Z",
  "lastName": "Johnson",
  "level": "member",
  "userId": "usr_1234567890abcdef1234567890abcdef",
  "middleName": "Marie",
  "npiNumber": "1234567893",
  "phoneNumber": "5551234567",
  "suffix1": "MD",
  "suffix2": "FACR"
}
Returns Examples
{
  "canCreateReports": true,
  "canManageStudies": true,
  "clinicRole": "Radiologist",
  "createdAt": "2024-01-15T10:00:00Z",
  "email": "dr.johnson@hospital.org",
  "firstName": "Sarah",
  "hasDashboardAccess": true,
  "invitedSource": "api",
  "lastLoginAt": "2024-03-15T09:00:00Z",
  "lastName": "Johnson",
  "level": "member",
  "userId": "usr_1234567890abcdef1234567890abcdef",
  "middleName": "Marie",
  "npiNumber": "1234567893",
  "phoneNumber": "5551234567",
  "suffix1": "MD",
  "suffix2": "FACR"
}