---
title: "Send a notification queue entry now"
method: POST
path: "/api/servicetodo/processes/notification-queue/{uuid}/send-now"
tags: ["notificationQueue"]
---

# Send a notification queue entry now

`POST /api/servicetodo/processes/notification-queue/{uuid}/send-now`

## Request

- Base URL: `https://services.fountain.com`
- URL: `https://services.fountain.com/api/servicetodo/processes/notification-queue/{uuid}/send-now`
- Auth: HTTP bearer

Sends a planned or scheduled notification immediately instead of at its scheduled time. Answers 409 when the worker is finished or terminated, when the flow no longer needs the notification, when the worker, the flow or the worker's membership in it no longer exists, or when the scheduler already claimed it. Gated behind the NOTIFICATIONS_V2 feature flag.

## Path parameters

- `uuid` string, uuid, required

## Response `200`

Returns the notification queue entry after the send.

- object
  - `data` object, required
    - `uuid` string, uuid, required
    - `workerUuid` string, uuid, required
    - `workerDisplayName` string, required
    - `taskFlowUuid` string, uuid, required
    - `notificationType` 'initial' | 'deadline' | 'reminder' | 'newTask' | 'adHoc' | 'flowCompleted' | 'flowUpdated' | 'deadlineMissed', required
    - `channel` 'email' | 'sms', required
    - `status` 'upcoming' | 'sent' | 'cancelled' | 'skipped', required: The UI-facing status bucket (upcoming/sent/cancelled/skipped) — never the raw backend status.
    - `scheduledAt` string, date-time, required: ISO 8601 UTC. Converting to the viewer local timezone is a UI concern.
    - `sentAt` string, date-time, nullable, required
    - `cancelReason` 'workerTerminated' | 'workerOutOfTaskflow' | 'taskflowArchived' | 'taskflowCompleted' | 'taskflowSuperseded' | 'channelDisabled' | 'membershipGone' | 'workerLeftFlow' | 'workerAlreadyStarted': Why the notification was cancelled, when the cancel recorded a reason. Absent otherwise: an admin cancel records none.
  - `meta` ResponsesPartMeta, required
    - `timestamp` string, date-time, required
    - `verb` 'OPTION' | 'GET' | 'PUT' | 'POST' | 'PATCH' | 'DELETE'
    - `path` string
    - `jti` string
    - `rid` string
    - `count` number
    - `capped` boolean: The server lowered filter[limit] to its ceiling. Page with filter[skip] to read past it.
    - `status` string
    - `duration` number
    - `size` number

## Other responses

- `403`: default error response
- `404`: default error response
- `409`: default error response

---

[API](https://skmtc.dev/fountain/apis/worker-experience-public-api.md) - [All operations](https://skmtc.dev/fountain/apis/worker-experience-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fountain/apis/worker-experience-public-api/revisions/6b9a31f79e22?raw)
