A custom origin is a subdomain that is configured for a specific customer and looks like, abc.pubnubapi.com. Using a custom origin allows PubNub to route traffic per customer when a PoP is not performing well or becomes unavailable or implementing custom configurations that may be required by a customer for a specific use case or region. If you do not already have a custom origin you can request one by sending a support ticket. Please provide the following information in the support ticket:

  • PubNub account email address
  • Desired custom origin name (the abc part of abc.pubnubapi.com)
  • A list of all PubNub SDK languages and versions 

Once you have your custom origin, you can start using it by changing how you initialize the PubNub instance in your SDK. The Support team will provide the required SDK init code for each SDK/version provided in the support ticket. 


A custom origin is a subdomain that is configured for a specific customer and looks like: abc.pubnubapi.com


Using a custom origin allows PubNub to route traffic per customer when a point of presence (PoP) is not performing well or becomes unavailable. It also allows for custom configurations that may be required by a customer for a specific use case or region. 


If you do not already have a custom origin you can request by filing a support ticket with PubNub Support, using the subject, Request Custom Origin. Be sure to provide the following to support in the ticket message body:

  1. The Pubnub account email with that has or will have the paid production key set(s)

  2. Three choices for your subdomain in order of preference (12 characters or less)

  3. The PubNub SDKs you currently use in your applications: SDK language/name and version

  4. Do you have customers or devices in China?


PubNub Support will provide you with confirmation on your custom origin name and sample code to configure each of the PubNub SDKs/versions you are using in your applications.