---
title: "Subscribe to flow notifications"
method: POST
path: "/flows/{flow_id}/subscriptions"
tags: ["flows"]
---

# Subscribe to flow notifications

`POST /flows/{flow_id}/subscriptions`

Subscribe the current user to notifications for a specific flow event type (e.g., TASK_PROCESSING_ERROR, FLOW_STOPPED, or TASK_OPERATIONAL_ERROR).
The user must be a member of the workspace to which the flow belongs.

## Path parameters

- `flow_id` string, required

## Request body

- object
  - `notification_type` 'TASK_PROCESSING_ERROR' | 'FLOW_STOPPED' | 'TASK_OPERATIONAL_ERROR', required — Type of event to subscribe to

## Response `201`

Subscription created

- object
  - `data` object
    - `id` string — Subscription ID
    - `type` 'subscription' — Resource type
    - `attributes` object
      - `type` 'TASK_PROCESSING_ERROR' | 'FLOW_STOPPED' | 'TASK_OPERATIONAL_ERROR' — Notification type
    - `relationships` object
      - `flow` object
        - `data` object
          - `id` string — Flow ID
          - `type` 'flow' — Resource type

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/elastic/apis/elastic-io-rest-api-documentation-v2.md) · [All operations](https://skmtc.net/elastic/apis/elastic-io-rest-api-documentation-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elastic/elastic-io-rest-api-documentation-v2/revisions/411f9f98c01e/schema)