POST api/Village/{village}/Event

Create a new event

Request Information

URI Parameters

Name	Description	Type	Additional information
village	Village ID	globally unique identifier	Required

Body Parameters

CreateEventModel

Name	Description	Type	Additional information
Description	Full description of the event	string	Data type: MultilineText String length: inclusive between 0 and 4000
Priority	Whether or not the event is priority	boolean	None.
NeedAssignees	Event requires assignees (i.e. Assignees is toggled on)	boolean	None.
StartTime	Event's Start Date and Time	date	Required
EndTime	Events End Date and Time	date	Required
AllDay	If true, this is an all day event and the time portion of StartTime/EndTime are not relevant	boolean	None.
Location	Location of event	string	String length: inclusive between 0 and 255
Address	Event Location Address	OptionalAddressModel	None.
ReminderInterval	Event reminder interval	integer	None.
Recurrence	For recurring events, the recurrence definition. null, otherwise.	EditEventRecurrenceModel	None.
AssignedTo	List of User IDs the activity should be assigned to	Collection of globally unique identifier	None.
Tags	List of tags for the activity	Collection of string	None.
TimeZone	Time Zone for the Event/Reminder	string	None.
Title	Short title for the activity	string	Required String length: inclusive between 0 and 255

Request Formats

application/json, text/json

Sample:

{
  "Description": "sample string 1",
  "Priority": true,
  "NeedAssignees": true,
  "StartTime": "2025-06-03T04:30:37.161+00:00",
  "EndTime": "2025-06-03T04:30:37.161+00:00",
  "AllDay": true,
  "Location": "sample string 7",
  "Address": {
    "Address1": "sample string 1",
    "Address2": "sample string 2",
    "City": "sample string 3",
    "State": "sample string 4",
    "Zip": "sample string 5",
    "Country": "sample string 6"
  },
  "ReminderInterval": 1,
  "Recurrence": {
    "EventId": "e3f54bfc-2e1c-486b-8af0-77a925e72693",
    "EndDate": "2025-06-03T04:30:37.161+00:00",
    "Count": 2,
    "Frequency": 0,
    "Interval": 3,
    "Weekdays": 1
  },
  "AssignedTo": [
    "06f80200-8225-4069-ba65-2abe9d911581",
    "077a94ff-7814-47d0-ad65-6f5bbe5b80f7"
  ],
  "Tags": [
    "sample string 1",
    "sample string 2"
  ],
  "TimeZone": "sample string 8",
  "Title": "sample string 9"
}

application/xml, text/xml

Sample:

<CreateEventModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/CaringVillage.Shared.Implementation.Models">
  <Title>sample string 9</Title>
  <AssignedTo xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:guid>06f80200-8225-4069-ba65-2abe9d911581</d2p1:guid>
    <d2p1:guid>077a94ff-7814-47d0-ad65-6f5bbe5b80f7</d2p1:guid>
  </AssignedTo>
  <Tags xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </Tags>
  <TimeZone>sample string 8</TimeZone>
  <Address xmlns:d2p1="http://schemas.datacontract.org/2004/07/CaringVillage.Utilities">
    <d2p1:Address1>sample string 1</d2p1:Address1>
    <d2p1:Address2>sample string 2</d2p1:Address2>
    <d2p1:City>sample string 3</d2p1:City>
    <d2p1:Country>sample string 6</d2p1:Country>
    <d2p1:State>sample string 4</d2p1:State>
    <d2p1:Zip>sample string 5</d2p1:Zip>
  </Address>
  <AllDay>true</AllDay>
  <Description>sample string 1</Description>
  <EndTime>2025-06-03T04:30:37.1619216+00:00</EndTime>
  <Location>sample string 7</Location>
  <NeedAssignees>true</NeedAssignees>
  <Priority>true</Priority>
  <Recurrence>
    <Count>2</Count>
    <EndDate>2025-06-03T04:30:37.1619216+00:00</EndDate>
    <EventId>e3f54bfc-2e1c-486b-8af0-77a925e72693</EventId>
    <Frequency>None</Frequency>
    <Interval>3</Interval>
    <Weekdays>Sunday</Weekdays>
  </Recurrence>
  <ReminderInterval>1</ReminderInterval>
  <StartTime>2025-06-03T04:30:37.1619216+00:00</StartTime>
</CreateEventModel>

multipart/form-data

Sample:

Failed to generate the sample for media type 'multipart/form-data'. Cannot use formatter 'MultipartMediaTypeFormatter' to write type 'CreateEventModel'.

Response Information

Resource Description

The newly created event's ID

ViewEventModel

Name	Description	Type	Additional information
Description	Full description of the event	string	None.
NeedAssignees	Event requires assignees (i.e. Assignees is toggled on)	boolean	None.
Priority	Whether or not the event is priority	boolean	None.
StartTime	Event's start Date and Time	date	None.
EndTime	Events end Date and Time	date	None.
AllDay	If true, this is an all day event and the time portion of StartTime/EndTime are not relevant	boolean	None.
Location	Location of event	string	None.
Address	Event Location Address	OptionalAddressModel	None.
Reminder	For Events which are actually ToDo reminders, contains the rest of the ToDo information	ReminderModel	None.
ReminderInterval	For Events which are events, the #minutes before the start to send a reminder	integer	None.
Recurrence	For recurring events, the recurrence definition. null, otherwise.	ViewEventRecurrenceModel	None.
TimeZone	Time Zone for the Event	string	None.
ActivityId	Activity's unique ID	globally unique identifier	None.
CreatedById	ID of the user who created the activity	globally unique identifier	None.
CreatedBy	Name of the user who created the activity	string	None.
Created	Date/Time when the activity was created	date	None.
AssignedTo	List of users the activity is assigned to	Collection of ActivityAssignmentModel	None.
Tags	List of tags for the activity	Collection of string	None.
Attachments	File attachments	Collection of AttachmentModel	None.
History	Activity activity history	Collection of ActivityHistoryModel	None.
CommentCount	Number of entries in History which are comments	integer	None.
VillageId	The ID of the village in which this activity belongs	globally unique identifier	None.
LastUpdated	The date/time this activity was last updated; useful for handling push notifications	date	None.
Cancelled	True for activities that have been cancelled. Default value is false	boolean	None.
Title	Short title for the activity	string	Required String length: inclusive between 0 and 255

Response Formats

application/json, text/json

Sample:

{
  "Description": "sample string 1",
  "NeedAssignees": true,
  "Priority": true,
  "StartTime": "2025-06-03T04:30:37.208+00:00",
  "EndTime": "2025-06-03T04:30:37.208+00:00",
  "AllDay": true,
  "Location": "sample string 7",
  "Address": {
    "Address1": "sample string 1",
    "Address2": "sample string 2",
    "City": "sample string 3",
    "State": "sample string 4",
    "Zip": "sample string 5",
    "Country": "sample string 6"
  },
  "Reminder": {
    "Reminder": "2025-06-03T04:30:37.208+00:00",
    "Completed": "2025-06-03T04:30:37.208+00:00",
    "CompletedById": "22beab2f-5bbb-46e7-b659-852439931886",
    "CompletedBy": "sample string 1"
  },
  "ReminderInterval": 1,
  "Recurrence": {
    "StartDate": "2025-06-03T04:30:37.208+00:00",
    "Exceptions": [
      {
        "Date": "2025-06-03T04:30:37.208+00:00"
      },
      {
        "Date": "2025-06-03T04:30:37.208+00:00"
      }
    ],
    "EventId": "b9625d03-898d-40de-8790-38d0ef5eaa6a",
    "EndDate": "2025-06-03T04:30:37.208+00:00",
    "Count": 3,
    "Frequency": 0,
    "Interval": 4,
    "Weekdays": 1
  },
  "TimeZone": "sample string 8",
  "ActivityId": "d7e0de19-c33b-41fe-8791-610bee72e29d",
  "CreatedById": "930d629d-fb9d-4060-ba9e-d6ecb0ad203b",
  "CreatedBy": "sample string 11",
  "Created": "2025-06-03T04:30:37.208+00:00",
  "AssignedTo": [
    {
      "UserId": "8bd7f32f-4fbf-42b7-bed7-4db9b1178ef8",
      "Name": "sample string 2"
    },
    {
      "UserId": "8bd7f32f-4fbf-42b7-bed7-4db9b1178ef8",
      "Name": "sample string 2"
    }
  ],
  "Tags": [
    "sample string 1",
    "sample string 2"
  ],
  "Attachments": [
    {
      "Id": "045164a8-1449-4419-87af-1ff7c663df1e",
      "Size": 2,
      "FileName": "sample string 3",
      "ContentType": "sample string 4",
      "UploadedBy": "sample string 5"
    },
    {
      "Id": "045164a8-1449-4419-87af-1ff7c663df1e",
      "Size": 2,
      "FileName": "sample string 3",
      "ContentType": "sample string 4",
      "UploadedBy": "sample string 5"
    }
  ],
  "History": [
    {
      "HistoryId": "9073f9d0-93ee-4387-9fb3-307f8993831f",
      "ActivityId": "5f8b831c-49bf-4e08-97d1-21de18a7df21",
      "PerformedById": "46d155e6-b02e-48a4-9542-cf8516a09e4a",
      "PerformedBy": "sample string 4",
      "AssignedToId": "67f856fc-54f7-43f8-96ce-c3aef5375728",
      "AssignedTo": "sample string 5",
      "Action": "Comment",
      "DateTime": "2025-06-03T04:30:37.208+00:00",
      "Comments": "sample string 7",
      "Updated": "2025-06-03T04:30:37.208+00:00",
      "UpdatedById": "b8936faf-50c1-4c16-8867-8f3638593507",
      "UpdatedBy": "sample string 10"
    },
    {
      "HistoryId": "9073f9d0-93ee-4387-9fb3-307f8993831f",
      "ActivityId": "5f8b831c-49bf-4e08-97d1-21de18a7df21",
      "PerformedById": "46d155e6-b02e-48a4-9542-cf8516a09e4a",
      "PerformedBy": "sample string 4",
      "AssignedToId": "67f856fc-54f7-43f8-96ce-c3aef5375728",
      "AssignedTo": "sample string 5",
      "Action": "Comment",
      "DateTime": "2025-06-03T04:30:37.208+00:00",
      "Comments": "sample string 7",
      "Updated": "2025-06-03T04:30:37.208+00:00",
      "UpdatedById": "b8936faf-50c1-4c16-8867-8f3638593507",
      "UpdatedBy": "sample string 10"
    }
  ],
  "CommentCount": 2,
  "VillageId": "e7911df9-e53a-48e6-9e26-2bc23f992573",
  "LastUpdated": "2025-06-03T04:30:37.208+00:00",
  "Cancelled": true,
  "Title": "sample string 16"
}

application/xml, text/xml

Sample:

<ViewEventModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/CaringVillage.Shared.Implementation.Models">
  <Title>sample string 16</Title>
  <ActivityId>d7e0de19-c33b-41fe-8791-610bee72e29d</ActivityId>
  <AssignedTo>
    <ActivityAssignmentModel>
      <Name>sample string 2</Name>
      <UserId>8bd7f32f-4fbf-42b7-bed7-4db9b1178ef8</UserId>
    </ActivityAssignmentModel>
    <ActivityAssignmentModel>
      <Name>sample string 2</Name>
      <UserId>8bd7f32f-4fbf-42b7-bed7-4db9b1178ef8</UserId>
    </ActivityAssignmentModel>
  </AssignedTo>
  <Attachments>
    <AttachmentModel>
      <ContentType>sample string 4</ContentType>
      <FileName>sample string 3</FileName>
      <Id>045164a8-1449-4419-87af-1ff7c663df1e</Id>
      <Size>2</Size>
      <UploadedBy>sample string 5</UploadedBy>
    </AttachmentModel>
    <AttachmentModel>
      <ContentType>sample string 4</ContentType>
      <FileName>sample string 3</FileName>
      <Id>045164a8-1449-4419-87af-1ff7c663df1e</Id>
      <Size>2</Size>
      <UploadedBy>sample string 5</UploadedBy>
    </AttachmentModel>
  </Attachments>
  <Cancelled>true</Cancelled>
  <Created>2025-06-03T04:30:37.2088583+00:00</Created>
  <CreatedBy>sample string 11</CreatedBy>
  <CreatedById>930d629d-fb9d-4060-ba9e-d6ecb0ad203b</CreatedById>
  <History>
    <ActivityHistoryModel>
      <ActivityId>5f8b831c-49bf-4e08-97d1-21de18a7df21</ActivityId>
      <AssignedTo>sample string 5</AssignedTo>
      <AssignedToId>67f856fc-54f7-43f8-96ce-c3aef5375728</AssignedToId>
      <Comments>sample string 7</Comments>
      <DateTime>2025-06-03T04:30:37.2088583+00:00</DateTime>
      <HistoryId>9073f9d0-93ee-4387-9fb3-307f8993831f</HistoryId>
      <PerformedBy>sample string 4</PerformedBy>
      <PerformedById>46d155e6-b02e-48a4-9542-cf8516a09e4a</PerformedById>
      <Updated>2025-06-03T04:30:37.2088583+00:00</Updated>
      <UpdatedBy>sample string 10</UpdatedBy>
      <UpdatedById>b8936faf-50c1-4c16-8867-8f3638593507</UpdatedById>
    </ActivityHistoryModel>
    <ActivityHistoryModel>
      <ActivityId>5f8b831c-49bf-4e08-97d1-21de18a7df21</ActivityId>
      <AssignedTo>sample string 5</AssignedTo>
      <AssignedToId>67f856fc-54f7-43f8-96ce-c3aef5375728</AssignedToId>
      <Comments>sample string 7</Comments>
      <DateTime>2025-06-03T04:30:37.2088583+00:00</DateTime>
      <HistoryId>9073f9d0-93ee-4387-9fb3-307f8993831f</HistoryId>
      <PerformedBy>sample string 4</PerformedBy>
      <PerformedById>46d155e6-b02e-48a4-9542-cf8516a09e4a</PerformedById>
      <Updated>2025-06-03T04:30:37.2088583+00:00</Updated>
      <UpdatedBy>sample string 10</UpdatedBy>
      <UpdatedById>b8936faf-50c1-4c16-8867-8f3638593507</UpdatedById>
    </ActivityHistoryModel>
  </History>
  <LastUpdated>2025-06-03T04:30:37.2088583+00:00</LastUpdated>
  <Tags xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </Tags>
  <VillageId>e7911df9-e53a-48e6-9e26-2bc23f992573</VillageId>
  <Address xmlns:d2p1="http://schemas.datacontract.org/2004/07/CaringVillage.Utilities">
    <d2p1:Address1>sample string 1</d2p1:Address1>
    <d2p1:Address2>sample string 2</d2p1:Address2>
    <d2p1:City>sample string 3</d2p1:City>
    <d2p1:Country>sample string 6</d2p1:Country>
    <d2p1:State>sample string 4</d2p1:State>
    <d2p1:Zip>sample string 5</d2p1:Zip>
  </Address>
  <AllDay>true</AllDay>
  <Description>sample string 1</Description>
  <EndTime>2025-06-03T04:30:37.2088583+00:00</EndTime>
  <Location>sample string 7</Location>
  <NeedAssignees>true</NeedAssignees>
  <Priority>true</Priority>
  <Recurrence>
    <Count>3</Count>
    <EndDate>2025-06-03T04:30:37.2088583+00:00</EndDate>
    <EventId>b9625d03-898d-40de-8790-38d0ef5eaa6a</EventId>
    <Frequency>None</Frequency>
    <Interval>4</Interval>
    <Weekdays>Sunday</Weekdays>
    <Exceptions>
      <EventRecurrenceExceptionsModel>
        <Date>2025-06-03T04:30:37.2088583+00:00</Date>
      </EventRecurrenceExceptionsModel>
      <EventRecurrenceExceptionsModel>
        <Date>2025-06-03T04:30:37.2088583+00:00</Date>
      </EventRecurrenceExceptionsModel>
    </Exceptions>
    <StartDate>2025-06-03T04:30:37.2088583+00:00</StartDate>
  </Recurrence>
  <Reminder>
    <Completed>2025-06-03T04:30:37.2088583+00:00</Completed>
    <CompletedBy>sample string 1</CompletedBy>
    <CompletedById>22beab2f-5bbb-46e7-b659-852439931886</CompletedById>
    <Reminder>2025-06-03T04:30:37.2088583+00:00</Reminder>
  </Reminder>
  <ReminderInterval>1</ReminderInterval>
  <StartTime>2025-06-03T04:30:37.2088583+00:00</StartTime>
  <TimeZone>sample string 8</TimeZone>
</ViewEventModel>