OpenStreetMap Webhook Trigger

Receive external map or field-app events for OpenStreetMap workflows

OpenStreetMap Webhook Trigger

AI-generated

Summary

Receive external map or field-app events via a configurable webhook endpoint.

Inputs

  • path (required) — Path for external map tools or field apps. OSM itself does not send native webhooks.
  • httpMethod — HTTP method used for the webhook endpoint (POST or GET). Defaults to POST.
  • authentication — Authentication method for the webhook (None or Header Secret). Defaults to None.
  • secretHeaderName — Name of the header that carries the secret when using Header Secret authentication.
  • secretHeaderValue — Secret value for Header Secret authentication (hidden input).

Output shape

a single workflow item containing request body, query parameters, headers, receipt timestamp, and a note

The shape is always a single record; on authentication failure an error is thrown, otherwise the record is emitted.

Examples

Example 1: Trigger workflow on POST from an external mapping app

Path: openstreetmap-event, HTTP Method: POST, Authentication: Header Secret, Secret Header Name: x-osm-webhook-secret, Secret Header Value: mysecret

Example 2: Simple GET health check

Path: openstreetmap-event, HTTP Method: GET, Authentication: None

Example 3: Default configuration with no authentication

Path: openstreetmap-event, HTTP Method: POST, Authentication: None (all other defaults)

Links

Discussion