---
title: "Internal Notify"
method: POST
path: "/v1/internal/notify"
tags: ["internal-notify"]
---

# Internal Notify

`POST /v1/internal/notify`

## Request

- Base URL: `https://api.storyflo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.storyflo.com/v1/internal/notify`
- Auth: none declared

Send ONE allowlisted transactional email on behalf of a sibling product.

404 while ``INTERNAL_NOTIFY_ENABLED`` is off (checked before auth).
401 on a missing/incorrect bearer token, or when no token is configured.

## Headers

- `Authorization` string, nullable

## Request body

- union
  - NewRoundRequest
    - `to` string, required
    - `template` 'signalflo_new_round', required
    - `params` NewRoundParams, required: Typed parameters for the ``signalflo_new_round`` template.
      - `desk_name` string, required
      - `round_title` string, required
      - `round_url` string, required
      - `thesis` string, nullable
      - `unsubscribe_url` string, nullable
  - TelegramIdentityLinkRequest
    - `to` string, required
    - `template` 'telegram_identity_link', required
    - `params` TelegramIdentityLinkParams, required: Typed parameters for the ``telegram_identity_link`` template. signalflo has no mailer of its own, so the Telegram Mini App's "link your email" step hands the one-time code to this relay.
      - `code` string, required
      - `expires_at` string, required

## Response `200`

Successful Response

- NotifyResponse
  - `ok` boolean, required
  - `template` string, required
  - `message_id` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/storyflo/apis/storyflo-inference-router.md) · [All operations](https://skmtc.dev/storyflo/apis/storyflo-inference-router/llms.txt) · [OpenAPI document](https://skmtc.dev/storyflo/apis/storyflo-inference-router/revisions/c3a1a735ac7a?raw)