Back to Documentation

Send Notifications with cURL

Use cURL to send push notifications directly from your terminal. This is perfect for testing, scripting, or integrating with shell-based workflows.

Example Request

curl -X POST https://thenotification.app/api/sendNotification \
  -H "app_key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "New Message",
    "body": "Check out this notification",
    "link": "https://example.com/page",
    "image": "https://picsum.photos/400/200"
  }'

Parameters

FieldRequiredDescription
titleYesNotification title
bodyYesNotification message
linkNoURL to open when tapped
imageNoImage URL to display

Success Response

{
  "success": true,
  "message": "Notification sent to 1 device(s)",
  "devices_sent": 1,
  "failed_count": 0
}