POST api/Calendar/PatientAppointmentPost

Patient Book Appointment

Request Information

URI Parameters

None.

Body Parameters

Name	Type	Additional information
EncounterTypeId	globally unique identifier	None.
EncounterTypeModeDurationId	globally unique identifier	None.
ProviderId	globally unique identifier	None.
UserId	globally unique identifier	Required
PatientId	globally unique identifier	None.
SpecialityId	globally unique identifier	None.
AppointmentOn	date	Required
SecondaryAppointmentOn	date	None.
Reason	string	Required String length: inclusive between 0 and 250
Note	string	String length: inclusive between 0 and 1000
ParentId	globally unique identifier	None.
ReferredParentId	globally unique identifier	None.
PaidAmount	decimal number	None.
AccountId	globally unique identifier	Required
ServiceId	globally unique identifier	None.
MethodId	integer	None.
IsCustomFormFlow	string	None.
DocIds	string	None.
Reasons	Collection of Reasons	None.

Request Formats

application/json, text/json

Sample:

{
  "EncounterTypeId": "b68640e0-9bc9-41f5-bc9d-a237cbbccde7",
  "EncounterTypeModeDurationId": "ce26cfc8-e5f5-43b3-909e-190a3cb27b69",
  "ProviderId": "c98d5258-3175-4011-8126-687db72bb20f",
  "UserId": "8a7b2e39-394e-4f00-a2cb-10eb35230f25",
  "PatientId": "5470b7a1-8748-420e-abe7-466c12173d54",
  "SpecialityId": "c9268cf4-15b4-4d45-a903-1c1610980216",
  "AppointmentOn": "2026-02-03T20:57:45.0398347-06:00",
  "SecondaryAppointmentOn": "2026-02-03T20:57:45.0398347-06:00",
  "Reason": "sample string 3",
  "Note": "sample string 4",
  "ParentId": "3f596b07-0ceb-466b-a5d6-f6de922ecf76",
  "ReferredParentId": "45eebba4-7333-4164-9b34-a648c2caaaf4",
  "PaidAmount": 5.0,
  "AccountId": "6285cbb4-49c7-4d05-a90d-8443a5f8aaad",
  "ServiceId": "8e0d6e52-e438-43bb-9c12-0e301a4a9cfc",
  "MethodId": 1,
  "IsCustomFormFlow": "sample string 7",
  "DocIds": "sample string 8",
  "Reasons": [
    {
      "ReasonId": "fc1e501d-c931-4560-8f08-1c2e053be64e"
    },
    {
      "ReasonId": "fc1e501d-c931-4560-8f08-1c2e053be64e"
    }
  ]
}

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

Schedule

Name	Type	Additional information
ID	globally unique identifier	None.
FacilityId	globally unique identifier	None.
ResourceID	globally unique identifier	None.
AppointmentTypeId	globally unique identifier	None.
PreferredPharmacyId	globally unique identifier	None.
EncounterTypeModeDurationId	globally unique identifier	None.
ServiceId	globally unique identifier	None.
FromUserType	character	None.
FromUserID	globally unique identifier	None.
UserId	globally unique identifier	None.
Title	string	None.
Reason	string	None.
CancelReason	string	None.
Type	string	None.
AppointmentOn	date	None.
SecondaryAppointmentOn	date	None.
FromDate	date	None.
Duration	integer	None.
Note	string	None.
ToDate	date	None.
StatusId	integer	None.
AppointmentCount	integer	None.
EncounterTypeModeId	integer	None.
RoomNo	string	None.
Option	string	None.
CallType	string	None.
CallRefId	string	None.
GuardianName	string	None.
Location	string	None.
SpecialityId	globally unique identifier	None.
ParentScheduleId	globally unique identifier	None.
DoctorId	globally unique identifier	None.
PaidDate	date	None.
AppointmentOnUTC	date	None.
SecondaryAppointmentOnUTC	date	None.
PaidAmount	decimal number	None.
AccountId	globally unique identifier	None.
GuardianId	globally unique identifier	None.
PatientReferralId	globally unique identifier	None.
ParentId	globally unique identifier	None.
PatientId	globally unique identifier	None.
IsGuardian	integer	None.
AppointmentModeId	integer	None.
ReferenceId	string	None.
VisitMode	string	None.
VisitCode	string	None.
Doctor	string	None.
MethodId	integer	None.
PayConceptId	integer	None.
PayMethodId	integer	None.
DocIds	Collection of string	None.
ReasonId	string	None.
DocId	string	None.
DoctorTimeZone	string	None.
PatientTimeZone	string	None.
PatientHummyurl	string	None.
DoctorOffset	integer	None.
PatientOffset	integer	None.
EncounterId	globally unique identifier	None.
DoctorZoneDate	string	None.
PrimaryPatient	string	None.
SessionId	string	None.
OldAppointmentOn	date	None.
OldAppointmentOnUTC	date	None.
OldSecondaryAppointmentOnUTC	date	None.
PortalType	string	None.
UserOffset	integer	None.
EncounterNo	string	None.
StatusName	string	None.
InsuranceName	string	None.
InsuranceId	globally unique identifier	None.
EncounterTypeId	globally unique identifier	None.
Patient	Patient	None.
EncounterType	EncounterType	None.
Resource	Resource	None.
Status	Status	None.
Facility	Facility	None.
Encounter	Encounter	None.
Member	Member	None.
Notification	Notification	None.
Speciality	Speciality	None.
ScheduleDetails	Collection of ScheduleDetail	None.
Members	Collection of Member	None.
customFormModel	Collection of CustomFormModel	None.
ModifiedBy	globally unique identifier	None.
ModifiedOn	date	None.
Modified	Member	None.

Response Formats

application/json

Sample:

Sample not available.

text/json

Sample:

Sample not available.