---
title: "Notify Event"
method: POST
path: "/v2/notify/{eventId}"
tags: ["Notify"]
---

# Notify Event

`POST /v2/notify/{eventId}`

## Request

- Base URL: `https://qstash-eu-central-1.upstash.io`
- URL: `https://qstash-eu-central-1.upstash.io/v2/notify/{eventId}`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `qstash_token`
- TypeScript: <https://skmtc.dev/upstash/apis/upstash-workflow-rest-api/docs/v2/notify/:eventId/post.ts> (a function with typed inputs; its response is checked against the schema)

Notify an event to all waiters listening for that event ID.

This endpoint broadcasts an event to all active waiters that are waiting for the specified event.
Each waiting workflow step receives the event data and continues execution.

**Important:** This is an "unsafe notify" operation - if there are no active waiters when the
notification is sent, the event is lost and will not be delivered later. For guaranteed delivery
within a specific workflow run, use the `/v2/notify/{workflowRunId}/{eventId}` endpoint instead.

## Path parameters

- `eventId` string, required

## Request body

- object

## Response `201`

Event notification sent successfully

- NotifyResponse[]: Array of notification results, one for each notified waiter.
  - `waiter` Waiter
    - `url` string: The URL that is waiting for the event notification.
    - `headers` object: The HTTP headers to send with the notification.
    - `deadline` integer: The Unix timestamp in seconds when the wait operation times out.
    - `timeoutBody` string, byte: The body to send if the wait times out.
    - `timeoutUrl` string: The URL to call if the wait times out.
    - `timeoutHeaders` object: The HTTP headers to send with the timeout callback.
  - `messageId` string: The ID of the notification message that was published.
  - `deduplicated` boolean: Whether this notification was deduplicated.
  - `error` string: Error message if the notification failed.
  - `workflowRunId` string: The workflow run ID if the notification was sent within a workflow.
  - `workflowCreatedAt` integer: The timestamp when the workflow run was created (Unix timestamp in milliseconds).

## Other responses

- `400`: Bad Request - Invalid event ID
- `401`: Unauthorized
- `429`: Rate Limit Exceeded
- `500`: Internal Server Error

---

[API](https://skmtc.dev/upstash/apis/upstash-workflow-rest-api.md) - [All operations](https://skmtc.dev/upstash/apis/upstash-workflow-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upstash/apis/upstash-workflow-rest-api/revisions/251bee05a7ec?raw)