Messages Introduction

Messages

This group of endpoints provides metadata about available event types in the PubNub platform.

The Messages endpoints serve as a discovery API, helping you explore what events can be monitored by Route Inputs. This is a read-only catalog that organizes PubNub events in a hierarchical structure: Sources → Producers → Message Types. Use these endpoints to understand what events are available before creating your Route Inputs and Routes.

Metadata Hierarchy:

  • Sources - Root PubNub objects that generate events (e.g., message, user, channel, notification)
  • Producers - Categories of events generated on a source (e.g., Presence API, PubSub API)
  • Message Types - Specific event types with detailed schemas (e.g., MessageSent, UserJoinedChannel)
  • Filters - Available filtering options for each message type

Key Features:

  • Discover all available event sources and types
  • Browse message types by producer or search by keyword
  • View available filters for precise event targeting
  • Query available action types (router integrations) for your account
  • Understand event schemas before configuring Route Inputs

Typical Discovery Flow:

  1. List sources to see top-level event categories
  2. Explore producers within a source
  3. Find specific message types that match your use case
  4. Review available filters for precise event matching
  5. Use this information to create targeted Route Inputs