---
title: "Creates a new management event"
method: POST
path: "/management-events"
tags: ["ManagementEvents"]
---

# Creates a new management event

`POST /management-events`

## Request

- Base URL: `https://api.alto.zoopladev.co.uk`
- URL: `https://api.alto.zoopladev.co.uk/management-events`
- Auth: `appAuth` (a scheme the document does not define)

Creates a new management event for the specified entity.

## Headers

- `AgencyRef` string, required

## Request body

- AltoPropertyManagementApiModelsRequestsCreateManagementEventRequest: Request model for creating a new management event
  - `eventType` string, required: The type of management event.
  - `linkedType` string, required: The entity associated with the management event.
  - `linkedId` integer, required: The id of the entity associated with the management event.
  - `negotiatorId` integer, required: The id of the negotiator associated with the management event.
  - `dueDate` string, date-time, nullable: The date the management event is due to be completed.
  - `notes` string, nullable: Additional notes for the management event.

## Response `201`

Success. Returns the newly created management event

- AltoPropertyManagementApiModelsResponsesManagementEvent
  - `id` string, nullable
  - `propertyId` string, nullable
  - `tenancyId` string, nullable
  - `branchId` string, nullable
  - `eventType` AltoPropertyManagementApiModelsResponsesManagementEventType
    - `key` string, nullable
    - `label` string, nullable
  - `status` 'Unspecified' | 'Pending' | 'InProgress' | 'Complete' | 'Cancelled' | 'Expired'
  - `priority` 'Unspecified' | 'High' | 'Normal' | 'Low'
  - `critical` boolean
  - `dueDate` string, date-time, nullable
  - `completionDate` string, date-time, nullable
  - `reminderDays` integer
  - `recurring` boolean
  - `rescheduledForDate` string, date-time, nullable
  - `notes` string, nullable
  - `createdDate` string, date-time, nullable
  - `modifiedDate` string, date-time, nullable

## Other responses

- `400`: Bad request

---

[API](https://skmtc.dev/alto/apis/alto-api.md) - [All operations](https://skmtc.dev/alto/apis/alto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alto/apis/alto-api/revisions/1b729d9b15a8?raw)