Skip to navigation
NotificationsNotification APIpush-notifications

Subscribe device tokens to topic

Subscribe one or more device tokens to a Firebase topic.

Features:

  • Bulk subscription of multiple tokens
  • Automatic topic creation if it doesn’t exist
  • Success/failure count for each operation
  • Idempotent operation (safe to retry)

Topic Naming:

  • Use descriptive names (e.g., “news”, “sports”, “offers”)
  • Support hierarchical topics (e.g., “news.sports.football”)
  • Topics are case-sensitive
  • Maximum topic name length: 900 characters

Management:

  • Devices can be subscribed to multiple topics
  • Subscriptions persist across app installations
  • Topics automatically clean up unused subscriptions

Authentication

AuthorizationBearer

JWT token for authentication. Use ‘test-jwt-token’ for development.

Request

This endpoint expects an object.
tokenslist of stringsRequired
topicstringRequired

Response

This endpoint returns an object.
successboolean
dataobjectOptional
errorobjectOptional