General Considerations

Keep these considerations in mind when using Pub/Sub API.

Pub/Sub API uses, for processing purposes, infrastructure that’s provided by Amazon Web Services, Inc. and located in the regions listed below. By using the Pub/Sub API, you agree to the use of AWS infrastructure for processing purposes and acknowledge that such processing can occur outside the region where your production org is located. Event processing can cause data in transit to pass through and exist temporarily in an external region. If you use the Pub/Sub API endpoint specific to the region where your org is located, event processing occurs in the same region as your org. For more information, see Pub/Sub API Endpoints and Regions, Availability Zones, and Local Zones in the AWS documentation.


  • Asia Pacific (Mumbai)
  • Europe (Frankfurt)
  • US East (N. Virginia)
  • US West (Oregon)

Events in the Salesforce event bus aren't persisted or stored outside the region where your org is located.

If channel membership or user permissions change after a subscription starts and while it’s active, the changes take effect within 10 minutes. For example, if a new member is added to the channel, the client receives events corresponding to the new member within 10 minutes. Similarly, if a user loses their View All permission on an entity included in a channel member, they stop receiving the entity’s change events within 10 minutes. If a channel is deleted, the subscription ends with an error within 10 minutes. A channel can be a change data capture channel or a custom platform event channel. For more information about change data capture channels and permissions, see Subscription Channels and Required Permissions for Change Events in the Change Data Capture Developer Guide. For more information about custom platform event channels, see Group Platform Events into One Stream with a Custom Channel in the Platform Events Developer Guide.

The Lock sessions to the IP address from which they originated setting in the Session Settings page in Setup must be disabled for Pub/Sub API. If you enable this setting, Pub/Sub API RPC calls fail. For more information, see Modify Session Security Settings in Salesforce Help.