POST PlanCare2Api/ClientAppointments/AgreementAppointments
Saves a new AgreementAppointment instance
Requires 'Start' permission for function ClientGroupCalendar {6D8B7697-D439-4E6E-9773-52E40081B837}
Request Information
URI Parameters
None.
Body Parameters
The AgreementAppointment instance
AgreementAppointment| Name | Description | Type | Additional information |
|---|---|---|---|
| AgreementId |
The id of the Agreement |
integer |
Required |
| ClientId |
The internal id of the client. |
integer |
Required |
| ClientName |
The name of the client. |
string |
- |
| EmployeeId |
The internal id of the employee who owns the appointment. |
integer |
Nullable |
| EmployeeName |
The name of the employee who owns the appointment. |
string |
- |
| EmploymentId |
The internal id of the employment of the specified employee. |
integer |
Nullable |
| ContractOfServiceId |
The internal id of the employment of the specified employee. |
integer |
Nullable Deprecated (unavailable from 21.01.1P): 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 |
- |
| Status |
Defines the status of the appointment. A Recurrence appointment will always have the status 'Created'. |
PlannedItemStatus |
- |
| StatusChangedByName |
The name of the employee who changed the status of the appointment. |
string |
- |
| StatusChangedById |
The id of the employee who changed the status of the appointment. |
integer |
- |
| CreatedByName |
The name of the employee who created the appointment. |
string |
- |
| CreatedById |
The id of the employee who created the appointment. |
integer |
- |
| Remarks |
Remarks made to the appointment. |
string |
- |
| Id |
The internal id of the appointment. |
integer |
Conditional Required: Only required for existing appointments |
| Location |
The location of the appointment. |
string |
- |
| 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 |
- |
| 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 |
- |
| 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 |
- |
| Type |
Defines the type of the appointment, default type is normal. |
AppointmentType |
- |
| ShiftId |
The Id of the Shift. |
integer |
Nullable |
| ContractInfo |
The appointment ContractInfo. |
string |
- |
| WeekPlanningId |
The Id of the WeekPlanning. |
integer |
Nullable |
Request Formats
application/json, text/json
{
"AgreementId": 1,
"ClientId": 2,
"ClientName": "sample string 3",
"EmployeeId": 1,
"EmployeeName": "sample string 4",
"EmploymentId": 1,
"ContractOfServiceId": 1,
"Start": "2026-05-26T22:07:36.3916241+02:00",
"End": "2026-05-26T22:07:36.3916241+02:00",
"Title": "sample string 7",
"Reason": "sample string 8",
"Status": 0,
"StatusChangedByName": "sample string 9",
"StatusChangedById": 10,
"CreatedByName": "sample string 11",
"CreatedById": 12,
"Remarks": "sample string 13",
"Id": 14,
"Location": "sample string 15",
"MovesToNextDay": true,
"IsAllDay": true,
"FriendlyRecurrenceInfo": "sample string 18",
"RecurrenceInfo": {
"$id": "2",
"OccurrenceCount": 1,
"Periodicity": 1,
"Range": 0,
"Interval": 0,
"WeekDays": 1,
"RecurrenceStart": "2026-05-26T22:07:36.3916241+02:00",
"RecurrenceEnd": "2026-05-26T22:07:36.3916241+02:00",
"Month": 1,
"DayNumber": 1,
"WeekOfMonth": 0
},
"RecurrenceOccurrences": [
{
"$id": "3",
"Id": 1,
"Start": "2026-05-26T22:07:36.3916241+02:00",
"End": "2026-05-26T22:07:36.3916241+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 19",
"WeekPlanningId": 1
}
application/xml, text/xml
<AgreementAppointment 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 19</ContractInfo>
<CreatedById xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">12</CreatedById>
<CreatedByName xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">sample string 11</CreatedByName>
<End xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">2026-05-26T22:07:36.3916241+02:00</End>
<FriendlyRecurrenceInfo xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">sample string 18</FriendlyRecurrenceInfo>
<Id xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">14</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 15</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 8</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:07:36.3916241+02:00</d2p1:RecurrenceEnd>
<d2p1:RecurrenceStart>2026-05-26T22:07:36.3916241+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:07:36.3916241+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:07:36.3916241+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:07:36.3916241+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:07:36.3916241+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 13</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:07:36.3916241+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">10</StatusChangedById>
<StatusChangedByName xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">sample string 9</StatusChangedByName>
<Title xmlns="http://schemas.datacontract.org/2004/07/DHS.PlanCare.Web.Api.Interface.Calendar">sample string 7</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>2</ClientId>
<ClientName>sample string 3</ClientName>
<ContractOfServiceId>1</ContractOfServiceId>
<EmployeeId>1</EmployeeId>
<EmployeeName>sample string 4</EmployeeName>
<EmploymentId>1</EmploymentId>
<AgreementId>1</AgreementId>
</AgreementAppointment>
Response Information
Resource Description
Returns the HttpResponseMessage which contains the saved AgreementAppointment instance
HttpResponseMessage| Name | Description | Type | Additional information |
|---|---|---|---|
| Version | Version |
- |
|
| Content | HttpContent |
- |
|
| StatusCode | HttpStatusCode |
- |
|
| ReasonPhrase | string |
- |
|
| Headers | Collection of Object |
- |
|
| RequestMessage | HttpRequestMessage |
- |
|
| IsSuccessStatusCode | boolean |
- |