---
schema_version: "1"
id: 50de0e28c2865cc62414098c751c95360643e043e6e2ee86d2116c35020422ff
title: Get Started with Pub/Sub API
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/event-bus/pub-sub-api/guides/intro.md
canonical_url: https://developer.salesforce.com/docs/platform/pub-sub-api/guide/intro.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 4fe956165a6058afdf7788de864975a223f93c06aee953b295f43b12fbebfdf7
products:
  - Pub/Sub API
  - Event Bus Docs
---
# Get Started with Pub/Sub API

Pub/Sub API provides a single interface for publishing and subscribing to platform events, including real-time event monitoring events, and change data capture events. Based on [gRPC API](https://grpc.io/docs/) and HTTP/2, Pub/Sub API efficiently publishes and delivers binary event messages in the Apache Avro format.

| REQUIRED EDITIONS                                                                        |
| ---------------------------------------------------------------------------------------- |
| Available in: **Enterprise**, **Performance**, **Unlimited**, and **Developer** Editions |
| Not Available in: Government Cloud | 


## Discover

Learn about Pub/Sub API by checking out the pages under these sections.

- [Get Started with Pub/Sub API](https://developer.salesforce.com/docs/platform/pub-sub-api/guide/intro.md) (this section)
- [Use Pub/Sub API](https://developer.salesforce.com/docs/platform/pub-sub-api/guide/use-pub-sub-api.md)

## Build an App

Learn how to create your first subscriber app and discover code samples.

- [Quick Starts](https://developer.salesforce.com/docs/platform/pub-sub-api/guide/quick-start.md)
- [Code Examples](https://developer.salesforce.com/docs/platform/pub-sub-api/guide/other-code-examples.md)
- [Reference](/docs/platform/pub-sub-api/references/)

## Use Cases

With Pub/Sub API, you can build event-driven integration apps. Here are some examples of what you can do.

- Publish and subscribe to custom platform events to send and receive real-time notifications in another system for business process integration. Some examples of business process integrations are sending real-time notifications for maintenance service or product orders.
- Subscribe to change data capture events, and synchronize order data in an external inventory system.
- Subscribe to Event Monitoring real-time events, and publish a platform event back into Salesforce to restrict a user’s profile when they log into Salesforce after working hours.
- Subscribe to a standard platform event, such as AppointmentSchedulingEvent, and integrate with Google Calendar to update users’ calendars.

## Pub/Sub API Benefits

Learn about what Pub/Sub API offers.

- Publishing, subscribing, and event schema retrieval all in one API.
- Final publish results of publish operations, and not intermediate queueing results.
- Flow control that lets you specify how many events to receive in a subscribe call based on event processing speed in the client.
- Scalable and secure publishing and delivery of platform events, change data capture events, and real-time event monitoring events.
- Real-time, highly performant data streaming that uses compression through HTTP/2.
- Support for 11 programming languages in the client that are offered by the gRPC API, such as Python, Java, Node, and C++. For all the supported languages, see [https://grpc.io/docs/languages/](https://grpc.io/docs/languages/).
- An active online developer community presence for gRPC.
- Bidirectional data streaming through the gRPC API. The client and the server can send a sequence of messages to each other using two independent streams.
- Cross-cloud integration capabilities enabling the development of event-driven apps that integrate across Salesforce clouds.

## Pub/Sub API vs. Other Salesforce APIs

Simplify your development with Pub/Sub API by using a single API to work with events instead of using disparate APIs. This table compares the tasks that you perform with Pub/Sub API versus other APIs.

| **Task**                                                                                                                 | **Can accomplish with Pub/Sub API** | **How to accomplish with other APIs**   |
| ------------------------------------------------------------------------------------------------------------------------ | ----------------------------------- | --------------------------------------- |
| Publish platform events                                                                                                  | Pub/Sub API                         | Data APIs: SOAP API, REST API, Bulk API |
| Subscribe to events: platform events, change data capture events, real-time event monitoring events, and standard events | Pub/Sub API                         | Streaming API                           |
| Get the event schema                                                                                                     | Pub/Sub API                         | REST API                                |

**See Also**

- [Pub/Sub API and the Expanded Event Bus](https://developer.salesforce.com/docs/platform/pub-sub-api/guide/expanded-event-bus.md)
- [Pub/Sub API Features](https://developer.salesforce.com/docs/platform/pub-sub-api/guide/pub-sub-features.md)
