Send broadcast notification

POST

/api/v1/notifications/generic

notifications

Last modified:2026-06-04 22:55:16

Send a notification to all active opted-in users via Firebase multicast. Saves one generic that visible to all users in their notification feed. Admin only.

Request: Bearer token (admin)

Body: title, body, optional image_url

Success: 200 - returns { success, message } only (no data).

Errors: 401 - invalid token | 403 - not an admin | 422 - missing fields

Request

Body Params application/jsonRequired

Example

{
    "body": "Wishing you a year full of prosperity.",
    "deep_links": "hasta://home",
    "image_url": "https://images.hastaai.in/notifications/diwali.jpg",
    "metadata": {
        "screen": "home"
    },
    "title": "Happy Diwali!"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/notifications/generic' \
--header 'Content-Type: application/json' \
--data '{
    "body": "Wishing you a year full of prosperity.",
    "deep_links": "hasta://home",
    "image_url": "https://images.hastaai.in/notifications/diwali.jpg",
    "metadata": {
        "screen": "home"
    },
    "title": "Happy Diwali!"
}'

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "Notification sent"
}

🟠401Unauthorized

🟠403Forbidden

🟠422Parameter Error

Modified at 2026-06-04 22:55:16

Fetch all tracked events

Send custom notification to a user