---
title: "Create events"
method: POST
path: "/alarms/{alarm_id}/events"
tags: ["Alarms"]
---

# Create events

`POST /alarms/{alarm_id}/events`

Adds an event detected by a device to the alarm. If media is sent with a camera alarm, it will be shown to the dispatchers.

## Path parameters

- `alarm_id` string, required

## Request body

- object[]
  - `event_type` 'alarm.device.value_changed' | 'alarm.device.activated_alarm' | 'alarm.person.activated_alarm', required
  - `event_time` string, date-time, required
  - `meta` union, required — Data can have an attribute of smoke, camera, lock, motion, contact, network_connection, water_leak, or freeze.
    - object
      - `attribute` 'smoke', required
      - `value` 'detected' | 'clear', required
      - `device_id` string
      - `device_model` string, required
      - `device_name` string, required
      - `device_manufacturer` string, required
    - object
      - `attribute` 'camera', required
      - `value` 'unknown', required
      - `device_id` string
      - `device_model` string, required
      - `device_name` string, required
      - `device_manufacturer` string, required
      - `media` string
    - object
      - `attribute` 'lock', required
      - `value` 'locked' | 'unlocked' | 'door_open' | 'door_closed', required
      - `device_id` string
      - `device_model` string, required
      - `device_name` string, required
      - `device_manufacturer` string, required
    - object
      - `attribute` 'contact', required
      - `value` 'open' | 'closed', required
      - `device_id` string
      - `device_model` string, required
      - `device_name` string, required
      - `device_manufacturer` string, required
    - object
      - `attribute` 'motion', required
      - `value` 'detected' | 'cleared', required
      - `device_id` string
      - `device_model` string, required
      - `device_name` string, required
      - `device_manufacturer` string, required
    - object
      - `attribute` 'network_connection', required
      - `value` 'lost' | 'established', required
      - `device_id` string
      - `device_model` string, required
      - `device_name` string, required
      - `device_manufacturer` string, required
    - object
      - `attribute` 'water_leak', required
      - `value` 'detected' | 'cleared', required
      - `device_id` string
      - `device_model` string, required
      - `device_name` string, required
      - `device_manufacturer` string, required
    - object
      - `attribute` 'freeze', required
      - `value` 'detected' | 'cleared', required
      - `device_id` string
      - `device_model` string, required
      - `device_name` string, required
      - `device_manufacturer` string, required

## Response `201`

Created

---

[API](https://skmtc.net/noonlight/apis/dispatch-api.md) · [All operations](https://skmtc.net/noonlight/apis/dispatch-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/noonlight/dispatch-api/versions/5b0597c14df6/schema)