Create new provider user in existing organization
Create new provider user in an existing organization. This endpoint is for platform organizations that manage multiple practices. The organization must already exist and be accessible by the API key. Supports setting default note templates.
Path Parameters
- orgId string required
The organization ID where the user should be created
- application/json
Request Body required
- partnerUserId string
Optional user id in partner's system. Upheal will use this id, if specified, for user identification.
- firstName string required
User first name.
- lastName string required
User last name.
- email email required
Possible values:
non-emptyclient email address
- phoneNumber string
User's phone number
- phoneCountryCode string
User's phone country code
- locale string
Client locale. Optional.
- defaultNoteTemplateIds string[]
Optional list of default note template ids for the user.
- nationalProviderIdentifier string
Optional National Provider Identifier (NPI) number.
- therapyLicence string
Optional therapy license number.
- noteIdentifier string
Possible values: [
Therapist,Clinician,Coach,FirstName,DrLastName,Provider,Physician,Practitioner,Author,Writer,Counselor,Psychologist,PeerSupportSpecialist,CaseManager,Supervisor,Dietitian]Optional note identifier for how the provider is referred to in generated notes.
- 200
- 400
- 401
- 403
- 404
User created in organization.
- application/json
- Schema
- Example (from schema)
Schema
- userId string required
Id of created user.
- inviteUrl url required
Unique url link user can use to sign up.
- privateRoomLink string required
Private room link owned by the provider, usable by provider and all clients.
- partnerUserId string
Optional user id in partner's system. Upheal will use this id, if specified, for user identification.
- defaultNoteTemplateIds string[]
Optional list of default note template ids for the user.
- organizationId string
The organization ID the user belongs to.
- noteIdentifier string
Possible values: [
Therapist,Clinician,Coach,FirstName,DrLastName,Provider,Physician,Practitioner,Author,Writer,Counselor,Psychologist,PeerSupportSpecialist,CaseManager,Supervisor,Dietitian]Note identifier for how the provider is referred to in generated notes.
{
"userId": "d290f1ee-6c54-4b01-90e6-d701748f0852",
"inviteUrl": "https://app.upheal.io/invite/2fb81b0a-611b-11ed-9b6a-0242ac120002",
"privateRoomLink": "https://upheal.io/firstname-lastname-123",
"partnerUserId": "string",
"defaultNoteTemplateIds": [
"2fb81b0a-611b-11ed-9b6a-0242ac120002"
],
"organizationId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
"noteIdentifier": "Provider"
}
Invalid request parameters.
Missing or invalid API key.
API key not allowed to create user in this organization.
Organization not found.