---
title: "Create a signal (beacon ping, capture, note, alert)"
method: POST
path: "/v1/signals"
tags: ["Signals"]
---

# Create a signal (beacon ping, capture, note, alert)

`POST /v1/signals`

Create a new org-scoped signal. Beacon pings are broadcast live and only persist a `beacon_on` record on first activation; other signal types are written to storage and optionally trigger push notifications.

## Request body

- object
  - `type` 'beacon' | 'capture' | 'note' | 'checkin' | 'alert', required
  - `lat` number
  - `lng` number
  - `accuracy` number
  - `image_url` string
  - `note` string
  - `ticket_id` number
  - `org_id` number — Override org — defaults to user primary org
  - `meta` object

## Response `201`

Default Response

- object

---

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