---
title: "Send notifications"
method: POST
path: "/v2/farcaster/frame/notifications/"
tags: ["Frame"]
---

# Send notifications

`POST /v2/farcaster/frame/notifications/`

Send notifications to interactors of a mini app. By default every broadcast is delivered synchronously and returns 200 with aggregate counts. When the `ASYNC_NOTIFICATIONS_ENABLED` server flag is on, broadcasts with more than 100 notification tokens are queued and return 202 with a campaign_id instead; poll the campaign stats endpoint for progress. Small broadcasts always stay synchronous.

## Request body

- SendFrameNotificationsReqBody
  - `filters` object — Filters to apply to the target_fids set. All filters are additive, so only users matching all filters will be notified.
    - `exclude_fids` Fid[] — Only send notifications to users who are not in the given FIDs.
    - `following_fid` integer — Only send notifications to users who follow the given FID.
    - `minimum_user_score` number — Only send notifications to users with a score greater than or equal to this value.
    - `near_location` object — Only send notifications to users near a given location.
      - `address` LocationAddress
        - `city` string, required
        - `country` string, required
        - `country_code` string
        - `state` string
        - `state_code` string
      - `latitude` number, double, required
      - `longitude` number, double, required
      - `radius` number — The radius in meters for the location search. Any location within this radius will be returned.
  - `notification` object, required
    - `body` string, required — The body of the notification. Must be between 1 and 128 characters.
    - `target_url` string, uri, required — The target URL to open when the user clicks the notification. Must be a valid URL.
    - `title` string, required — The title of the notification. Must be between 1 and 32 characters.
    - `uuid` string, uuid — An optional UUID for the notification, used as an idempotency key.
  - `target_fids` integer[] — An array of target FIDs to whom the notifications should be sent. Each FID must be a positive integer. Pass an empty array to send notifications to all FIDs with notifications enabled for the mini app.

## Response `200`

Success

- SendFrameNotificationsResponse
  - `campaign_id` string, uuid, required — The unique identifier for the notification campaign.
  - `failure_count` integer, required — The number of notifications that failed to deliver.
  - `not_attempted_count` integer, required — The number of notifications not attempted (e.g., disabled tokens, invalid tokens).
  - `retryable_fids` Fid[] — List of FIDs that failed due to retryable errors (rate_limited, failed, http_error). Can be used to retry sending notifications to these users.
  - `success_count` integer, required — The number of notifications successfully delivered.

## Other responses

- `202` — 202
- `400` — Bad Request
- `404` — Resource not found
- `422` — Unprocessable Content
- `500` — Server Error

---

[API](https://skmtc.dev/neynar/apis/neynar-api.md) · [All operations](https://skmtc.dev/neynar/apis/neynar-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/neynar/neynar-api/revisions/dbb91bfb0d1a/schema)