Push Notifications API

Ⓔ Enterprise Only

Overview

Push Notifications supports campaign creation, targeting, scheduling, API-triggered sends, user-level delivery history, and aggregate reporting.

Quick Links

• Message Create
• Message Update
• Message Remove
• Message Toggle
• Message Test
• Message Push
• Message List
• Message Get
• Message Estimate
• User History
• MIME Info
• Read Dashboard

Database Collections

Collection	Purpose
countly.messages	Push message definitions, content, trigger config, and result counters
countly.message_schedules	Message schedule state used by scheduling/status workflows
countly.app_users{appId}	User token fields and audience base for push delivery
countly.push_{appId}	Per-user push delivery history (msgs)
countly.events_data	Aggregated push sent/action event data for dashboard calculations
countly.creds	Push provider credentials and legacy FCM detection

Configuration & Settings

Push runtime settings affect delivery behavior:

• Proxy settings (proxyhost, proxyport, proxyuser, proxypass, proxyunauthorized) affect media URL metadata checks.
• Test audience settings (test.uids, test.cohorts) control /i/push/message/test execution scope.
• Sending pool and retry settings (connection_*, pool_*) affect push processing throughput.
• message_timeout affects when unsent notifications are treated as too late to send.

Trigger Types

• Plain (scheduled)
• Cohort/Event (automated)
• API-triggered

Last Updated

2026-03-07