---
title: "Fire a custom trigger with payload"
method: POST
path: "/triggers/{triggerId}/fire"
tags: ["Triggers"]
---

# Fire a custom trigger with payload

`POST /triggers/{triggerId}/fire`

Invoke a custom trigger directly with an arbitrary JSON payload.

Fan-out: a trigger may be referenced by multiple flows (workflows). Firing it enqueues one execution per enabled, non-deleted flow attached to this trigger, each receiving the same payload. The `enqueuedCount` in the response reports how many were enqueued (0 if no flows are attached, or if all matching flows are gated by a cooldown).

Payload validation:
- If the trigger has a `customPayloadSchema`, the payload is validated against it (JSON Schema via AJV).
- If no schema is configured, the payload only needs to be a JSON object — any keys and values are accepted.

Only triggers with `activation = "custom"` can be fired through this endpoint; event and schedule triggers return 409.

## Path parameters

- `triggerId` string, uuid, required

## Request body

- FireCustomTriggerBody
  - `payload` object, required — Arbitrary JSON object forwarded to every flow attached to this trigger. Validated against the trigger's customPayloadSchema when one is configured; otherwise only "must be a JSON object" is enforced.

## Response `202`

Custom trigger fired; one execution enqueued per enabled flow attached to this trigger

- object
  - `invocationId` string, uuid, required — Unique ID for this fire invocation. Job IDs in the execution queue are derived from it (one per enqueued flow).
  - `enqueuedCount` integer, required — Number of flow executions enqueued. May be 0 if no flows are attached to this trigger, or if all attached flows are currently in cooldown.

## Other responses

- `404` — Not Found
- `409` — Trigger exists but is not of type "custom"
- `422` — Validation Error
- `429` — Rate limit exceeded

---

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