---
title: "Create Trigger"
method: POST
path: "/api/v1/steps/{step_id}/trigger"
tags: ["steps"]
---

# Create Trigger

`POST /api/v1/steps/{step_id}/trigger`

## Path parameters

- `step_id` string, uuid, required

## Request body

- TriggerCreate — Attach a trigger to a root step.
  - `trigger_type` 'on_click' | 'schedule', required — How a root step can be triggered. EVENT (polling) was deprecated in commit c523d2be (2026-05-02) and deleted entirely in Phase 5: cross-dataset reactive updates use the cascade model (database_dep) instead. ON_CLICK is implicit (every dataset can be refreshed manually via the UI, no row needed) and is only kept here for the rejection branch in CreateTrigger.
  - `trigger_config` object

## Response `201`

Successful Response

- TriggerRead — Trigger response.
  - `id` string, uuid, required
  - `step_id` string, uuid, required
  - `trigger_type` 'on_click' | 'schedule', required — How a root step can be triggered. EVENT (polling) was deprecated in commit c523d2be (2026-05-02) and deleted entirely in Phase 5: cross-dataset reactive updates use the cascade model (database_dep) instead. ON_CLICK is implicit (every dataset can be refreshed manually via the UI, no row needed) and is only kept here for the rejection branch in CreateTrigger.
  - `trigger_config` object, required
  - `is_active` boolean, required
  - `last_triggered_at` string, date-time, nullable, required
  - `created_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

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