---
title: "POST /api/services/app/Appointment/Create"
method: POST
path: "/api/services/app/Appointment/Create"
tags: ["Appointment"]
---

# POST /api/services/app/Appointment/Create

`POST /api/services/app/Appointment/Create`

## Request body

- CreateAppointmentDto
  - `code` string, nullable — Max length 32
  - `idPatient` integer, nullable
  - `idHisPatient` integer, nullable
  - `patient` PatientDto
    - `code` string, nullable — Max length 50
    - `lastName` string, nullable — Max length 69
    - `firstName` string, nullable — Max length 30
    - `birthday` string, date-time
    - `gender` integer
    - `ethnicId` integer
    - `idCareer` integer, nullable
    - `identityCard` string, nullable — Max length 12
    - `identityDate` string, date-time, nullable
    - `phoneNumber` string, nullable — Max length 12; Regex pattern applied
    - `email` string, nullable — Max length 50
    - `mapLevel` 0 | 1 | 2 | 3 | 4 | 5
  - `idFamilyRelationship` integer, nullable
  - `relationship` PatientRelationshipDto
    - `relationType` string, nullable — Max length 50
    - `name` string, nullable — Max length 100
    - `phoneNumber` string, nullable — Max length 12
    - `mobileNumber` string, nullable — Max length 12
    - `address` string, nullable — Max length 512
    - `email` string, nullable — Max length 50
    - `identityCard` string, nullable — Max length 12
  - `address` AddressDto
    - `provinceId` integer
    - `provinceCode` string, nullable — Max length 3
    - `districtId` integer, nullable
    - `communeId` integer, nullable
    - `communeCode` string, nullable — Max length 6
    - `street` string, nullable — Max length 200
    - `fullAddress` string, nullable — Max length 512
  - `idClinicArea` integer
  - `idClinic` integer, nullable
  - `idService` integer, nullable
  - `idGroupDoctorLevel` integer, nullable
  - `idDoctorLevel` integer, nullable
  - `idDoctor` integer, nullable
  - `idServicePrice` integer
  - `amount` integer
  - `source` 0 | 1 | 2 | 3
  - `reason` string, nullable — Max length 512
  - `reasonPicture` string, nullable — Max length 1024
  - `date` string, date-time
  - `idConsultationShift` integer
  - `time` string, nullable
  - `requestInvoice` boolean
  - `requestSkinCare` boolean

## Response `200`

Success

- AppointmentDto
  - `id` string, uuid
  - `creationTime` string, date-time
  - `creatorUserId` integer, nullable
  - `lastModificationTime` string, date-time, nullable
  - `lastModifierUserId` integer, nullable
  - `treatmentCode` string, nullable
  - `code` string, nullable
  - `patientCode` string, nullable
  - `patientName` string, nullable
  - `patientYear` string, nullable
  - `patientGender` string, nullable
  - `idClinicArea` integer
  - `clinicAreaName` string, nullable
  - `idClinic` integer, nullable
  - `clinicName` string, nullable
  - `idGroupDoctorLevel` integer, nullable
  - `groupDoctorLevelName` string, nullable
  - `doctorLevelName` string, nullable
  - `idDoctor` integer, nullable
  - `doctorName` string, nullable
  - `ticketDoctorName` string, nullable
  - `serviceName` string, nullable
  - `reason` string, nullable
  - `reasonPicture` string, nullable
  - `amount` integer
  - `requestSkinCare` boolean
  - `date` string, date-time
  - `idConsultationShift` integer
  - `consultationShiftName` string, nullable
  - `index` integer
  - `examinationTimeRange` string, nullable
  - `expectedTime` string, nullable
  - `time` string, nullable
  - `status` 0 | 1 | 2 | 3 | 4 | -2 | -1
  - `treatmentStatus` 0 | 1 | 2 | 3 | 4 | 5 | -2 | -1
  - `cancelStatus` 0 | 1 | 2 | 3 | 4 | 5 | 6
  - `paymentStatus` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13
  - `statusName` string, nullable
  - `paymentStatusName` string, nullable
  - `treatmentStatusName` string, nullable
  - `cancelStatusName` string, nullable
  - `source` 0 | 1 | 2 | 3
  - `sourceName` string, nullable
  - `roomNumber` string, nullable
  - `departmentName` string, nullable
  - `surveyHref` string, nullable
  - `surveyTitle` string, nullable
  - `surveyDesc` string, nullable

---

[API](https://skmtc.dev/dalieu/apis/portaldalieu-api.md) · [All operations](https://skmtc.dev/dalieu/apis/portaldalieu-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dalieu/portaldalieu-api/revisions/78dcf1621c0e/schema)