Create and invite a new user

UserInviteResponse AutoScribe.Users.Invite(, )

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.

ParametersExpand Collapse

UserInviteParams parameters

required Boolean canCreateReports

required Boolean canManageStudies

required ClinicRole clinicRole

A user's clinical or organizational role within the clinic.

required string email

User's email address for login and notifications

required string firstName

User's first name

minLength1

required Boolean hasDashboardAccess

required string lastName

User's last name

minLength1

required AssignableUserLevel level

User access level assignable via the API. 'admin' can manage users/settings, 'member' has standard access. 'owner' is dashboard-only and cannot be assigned via the API.

string middleName

User's middle name (optional)

minLength1

string npiNumber

minLength10

maxLength10

string phoneNumber

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

string suffix1

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

minLength1

string suffix2

Additional name suffix (optional)

minLength1

ReturnsExpand Collapse

class UserInviteResponse:

Response for inviting a user to AutoScribe. Level is restricted to admin/member since owners cannot be invited via API.

required Boolean CanCreateReports

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

required Boolean CanManageStudies

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

required ClinicRole ClinicRole

A user's clinical or organizational role within the clinic.

Accepts one of the following:

required DateTimeOffset? CreatedAt

Timestamp when the user was created

formatdate-time

required string Email

User's email address for login and notifications

required string FirstName

User's first name

minLength1

required Boolean HasDashboardAccess

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

required InvitedSource InvitedSource

How a user/invitation was created - via the dashboard UI ('dashboard') or the API ('api').

Accepts one of the following:

required DateTimeOffset? LastLoginAt

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

formatdate-time

required string LastName

User's last name

minLength1

required AssignableUserLevel Level

User access level assignable via the API. 'admin' can manage users/settings, 'member' has standard access. 'owner' is dashboard-only and cannot be assigned via the API.

Accepts one of the following:

required string UserID

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

string MiddleName

User's middle name (optional)

minLength1

string NpiNumber

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

minLength10

maxLength10

string PhoneNumber

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

string Suffix1

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

minLength1

string Suffix2

Additional name suffix (optional)

minLength1

Create and invite a new user

UserInviteParams parameters = new()
{
    CanCreateReports = true,
    CanManageStudies = true,
    ClinicRole = ClinicRole.Radiologist,
    Email = "dr.johnson@hospital.org",
    FirstName = "Sarah",
    HasDashboardAccess = true,
    LastName = "Johnson",
    Level = AssignableUserLevel.Member,
};

var response = await client.AutoScribe.Users.Invite(parameters);

Console.WriteLine(response);

{
  "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"
}