# Create or update multiple events.

Endpoint: PUT /events
Version: v3
Security: oauth2

## Request fields (application/json):

  - `id` (string)
    Gets the event id which acts as the primary key in the database.

  - `name` (string,null, required)
    Gets or sets the event name.

  - `description` (string,null)
    Gets or sets the event description.

  - `startTime` (string, required)
    Gets or sets the event start time.

  - `endTime` (string,null)
    Gets or sets the event end time.

  - `eventTypeId` (integer, required)
    Gets the event type id which is defined by Willow, e.g. CalendarEvent, WeatherForecast, UtilityBill, ….

  - `eventSourceId` (string,null)
    Gets the name of the source system, which is for informational purposes.

  - `externalId` (string,null)
    Gets an Id linking it to the source system, facilitating updates and deletes.

  - `payload` (string,null, required)
    Gets or sets a JSON string containing type-specific values.

  - `payloadVersion` (string,null, required)
    Gets or sets a version for the payload to assist in the deserialization of the payload.

  - `scalarValue` (number,null)
    Gets or sets a double value that may be stored to complement the Payload value.

  - `twinId` (string,null, required)
    Gets the id of the twin that is a reference to to an existing space, or equipment twin.

  - `locations` (string,null)
    Gets or sets a JSON string with the expanded location ancestors for the twinId.

  - `createdDate` (string, required)
    Gets or sets the date the event was created in the system.

  - `lastModifiedDate` (string, required)
    Gets or sets the date the event was last modified in the system.

## Response 200 fields (text/plain):

  - `eventsCreatedCount` (integer)
    Gets or sets the number of created events.

  - `eventsUpdatedCount` (integer)
    Gets or sets the number of updated events.