POST PlanCare2Api/ClientAppointments/PCDContractAppointments

Saves a new ContractAppointment instance

Requires 'Start' permission for function ClientGroupCalendar {6D8B7697-D439-4E6E-9773-52E40081B837}

Request Information

URI Parameters

None.

Body Parameters

The PCD ContractAppointment instance

Name	Description	Type	Additional information
ContractId	The Id of the Contract	integer	Required
ProductId	The Id of the Product	integer	Required
ProjectId	The Id of the Project	string	Required
WorkTypeId	The Id of the Worktype	integer	None
ClientId	The internal id of the client.	integer	Required
ClientName	The name of the client.	string	None
EmployeeId	The internal id of the employee who owns the appointment.	integer	None
EmployeeName	The name of the employee who owns the appointment.	string	None
EmploymentId	The internal id of the employment of the specified employee.	integer	None
ContractOfServiceId	The internal id of the employment of the specified employee.	integer	Deprecated (unavailable from 11.36): Please use 'EmploymentId' instead.
Start	The start date and time of the appointment.	date	Required
End	The end date and time of the appointment.	date	Required
Title	The subject of the appointment.	string	Required
Reason	The given reason when the appointment is completed or cancelled.	string	None
Status	Defines the status of the appointment. A Recurrence appointment will always have the status 'Created'.	PlannedItemStatus	None
StatusChangedByName	The name of the employee who changed the status of the appointment.	string	None
StatusChangedById	The id of the employee who changed the status of the appointment.	integer	None
CreatedByName	The name of the employee who created the appointment.	string	None
CreatedById	The id of the employee who created the appointment.	integer	None
Remarks	Remarks made to the appointment.	string	None
Id	The internal id of the appointment.	integer	Conditional Required: Only required for existing appointments
Location	The location of the appointment.	string	None
MovesToNextDay	Determines whether the appointment will be moved to the next day when not completed.	boolean	Required
IsAllDay	Is the appointment created as an all-day appointment.	boolean	Required
FriendlyRecurrenceInfo	The user friendly description of the recurrence for the appointment. This description is readonly. Only set when type is Recurrence.	string	None
RecurrenceInfo	Defines the recurrence for the appointment. Only set when type is Recurrence. When creating a appointment the RecurrenceStart property of RecurrenceInfo must be equal to the Start property. Can be left empty if you want to remove the recurrence.	RecurrenceInfo	None
RecurrenceOccurrences	The list of occurrences if the appointment is recurrent. Only occurrences within the provided range are returned. Only set when type is Recurrence.	Collection of OccurrenceAppointment	None
Type	Defines the type of the appointment, default type is normal.	AppointmentType	None
ShiftId	The Id of the Shift.	integer	None
ContractInfo	The appointment ContractInfo.	string	None
WeekPlanningId	The Id of the WeekPlanning.	integer	None

Request Formats

application/json, text/json

Sample:

{
  "ContractId": 1,
  "ProductId": 2,
  "ProjectId": "sample string 3",
  "WorkTypeId": 1,
  "ClientId": 4,
  "ClientName": "sample string 5",
  "EmployeeId": 1,
  "EmployeeName": "sample string 6",
  "EmploymentId": 1,
  "ContractOfServiceId": 1,
  "Start": "2026-05-26T22:06:55.1509907+02:00",
  "End": "2026-05-26T22:06:55.1509907+02:00",
  "Title": "sample string 9",
  "Reason": "sample string 10",
  "Status": 0,
  "StatusChangedByName": "sample string 11",
  "StatusChangedById": 12,
  "CreatedByName": "sample string 13",
  "CreatedById": 14,
  "Remarks": "sample string 15",
  "Id": 16,
  "Location": "sample string 17",
  "MovesToNextDay": true,
  "IsAllDay": true,
  "FriendlyRecurrenceInfo": "sample string 20",
  "RecurrenceInfo": {
    "$id": "2",
    "OccurrenceCount": 1,
    "Periodicity": 1,
    "Range": 0,
    "Interval": 0,
    "WeekDays": 1,
    "RecurrenceStart": "2026-05-26T22:06:55.1509907+02:00",
    "RecurrenceEnd": "2026-05-26T22:06:55.1509907+02:00",
    "Month": 1,
    "DayNumber": 1,
    "WeekOfMonth": 0
  },
  "RecurrenceOccurrences": [
    {
      "$id": "3",
      "Id": 1,
      "Start": "2026-05-26T22:06:55.1509907+02:00",
      "End": "2026-05-26T22:06:55.1509907+02:00",
      "Title": "sample string 4",
      "Location": "sample string 5",
      "ParentId": 6,
      "OccurrenceIndex": 7,
      "Type": 0,
      "Reason": "sample string 8",
      "Status": 0,
      "StatusChangedByName": "sample string 9",
      "StatusChangedById": 10,
      "CreatedByName": "sample string 11",
      "CreatedById": 12,
      "Remarks": "sample string 13"
    },
    {
      "$ref": "3"
    }
  ],
  "Type": 0,
  "ShiftId": 1,
  "ContractInfo": "sample string 21",
  "WeekPlanningId": 1
}

application/xml, text/xml

Sample:

<PCDContractAppointment xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar.Client">
  <ContractInfo xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">sample string 21</ContractInfo>
  <CreatedById xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">14</CreatedById>
  <CreatedByName xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">sample string 13</CreatedByName>
  <End xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">2026-05-26T22:06:55.1509907+02:00</End>
  <FriendlyRecurrenceInfo xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">sample string 20</FriendlyRecurrenceInfo>
  <Id xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">16</Id>
  <IsAllDay xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">true</IsAllDay>
  <Location xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">sample string 17</Location>
  <MovesToNextDay xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">true</MovesToNextDay>
  <Reason xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">sample string 10</Reason>
  <RecurrenceInfo xmlns:d2p1="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar.Recurrence" xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">
    <d2p1:DayNumber>1</d2p1:DayNumber>
    <d2p1:Interval>Daily</d2p1:Interval>
    <d2p1:Month>1</d2p1:Month>
    <d2p1:OccurrenceCount>1</d2p1:OccurrenceCount>
    <d2p1:Periodicity>1</d2p1:Periodicity>
    <d2p1:Range>NoEndDate</d2p1:Range>
    <d2p1:RecurrenceEnd>2026-05-26T22:06:55.1509907+02:00</d2p1:RecurrenceEnd>
    <d2p1:RecurrenceStart>2026-05-26T22:06:55.1509907+02:00</d2p1:RecurrenceStart>
    <d2p1:WeekDays>Sunday</d2p1:WeekDays>
    <d2p1:WeekOfMonth>None</d2p1:WeekOfMonth>
  </RecurrenceInfo>
  <RecurrenceOccurrences xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">
    <OccurrenceAppointment>
      <CreatedById>12</CreatedById>
      <CreatedByName>sample string 11</CreatedByName>
      <End>2026-05-26T22:06:55.1509907+02:00</End>
      <Id>1</Id>
      <Location>sample string 5</Location>
      <OccurrenceIndex>7</OccurrenceIndex>
      <ParentId>6</ParentId>
      <Reason>sample string 8</Reason>
      <Remarks>sample string 13</Remarks>
      <Start>2026-05-26T22:06:55.1509907+02:00</Start>
      <Status>Created</Status>
      <StatusChangedById>10</StatusChangedById>
      <StatusChangedByName>sample string 9</StatusChangedByName>
      <Title>sample string 4</Title>
      <Type>Occurrence</Type>
    </OccurrenceAppointment>
    <OccurrenceAppointment>
      <CreatedById>12</CreatedById>
      <CreatedByName>sample string 11</CreatedByName>
      <End>2026-05-26T22:06:55.1509907+02:00</End>
      <Id>1</Id>
      <Location>sample string 5</Location>
      <OccurrenceIndex>7</OccurrenceIndex>
      <ParentId>6</ParentId>
      <Reason>sample string 8</Reason>
      <Remarks>sample string 13</Remarks>
      <Start>2026-05-26T22:06:55.1509907+02:00</Start>
      <Status>Created</Status>
      <StatusChangedById>10</StatusChangedById>
      <StatusChangedByName>sample string 9</StatusChangedByName>
      <Title>sample string 4</Title>
      <Type>Occurrence</Type>
    </OccurrenceAppointment>
  </RecurrenceOccurrences>
  <Remarks xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">sample string 15</Remarks>
  <ShiftId xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">1</ShiftId>
  <Start xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">2026-05-26T22:06:55.1509907+02:00</Start>
  <Status xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">Created</Status>
  <StatusChangedById xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">12</StatusChangedById>
  <StatusChangedByName xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">sample string 11</StatusChangedByName>
  <Title xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">sample string 9</Title>
  <Type xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">Normal</Type>
  <WeekPlanningId xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">1</WeekPlanningId>
  <ClientId>4</ClientId>
  <ClientName>sample string 5</ClientName>
  <ContractOfServiceId>1</ContractOfServiceId>
  <EmployeeId>1</EmployeeId>
  <EmployeeName>sample string 6</EmployeeName>
  <EmploymentId>1</EmploymentId>
  <ContractId>1</ContractId>
  <ProductId>2</ProductId>
  <ProjectId>sample string 3</ProjectId>
  <WorkTypeId>1</WorkTypeId>
</PCDContractAppointment>

Response Information

Resource Description

Returns the HttpResponseMessage which contains the saved ContractAppointment instance

HttpResponseMessage

Name	Type	Additional information
Version	Version	None
Content	HttpContent	None
StatusCode	HttpStatusCode	None
ReasonPhrase	string	None
Headers	Collection of Object	None
RequestMessage	HttpRequestMessage	None
IsSuccessStatusCode	boolean	None