Initialize PubNub

Before you start calling PubNub APIs, you must initialize the PubNub object in your app. This initialization uses the publish and subscribe keys you got from the Admin Portal and allows you to work with PubNub functionality. The PubNub object is also where you configure the behavior of the client, such as what to do when a connection is interrupted or whether to encrypt messages.

You only need to provide subscribeKey and userId if you want your app to receive messages. If you plan on sending messages, you must configure publishKey as well. There are other ways of initializing PubNub, depending on the features you want to use.

note
Make userId descriptive

It's up to you to define a userId, which is a UTF-8 encoded string of up to 92 characters used to identify the device that connects to PubNub.

Check out how easy it is:

var pubnub = new PubNub({
publishKey: "myPublishKey",
subscribeKey: "mySubscribeKey",
userId: "myUniqueUserId"
});
User ID / UUID

User ID is also referred to as UUID/uuid in some APIs and server responses but holds the value of the userId parameter you set during initialization.

You don't have to create a separate PubNub object every time you want to send or receive a message. After the initialization, subscribeKey, publishKey, and userId are reused for all operations.

Let's look into the userId parameter a bit more.

Last updated on
On this page