CreateBlogSupport
Log inSign up
Home
Webex Meetings
  • Overview
  • Guides
  • API Behavior Changes
  • REST API Basics
  • API REFERENCE
  • All APIs
  • Changelog
  • SDK
  • AI Assistant for Developers
  • Widgets
  • Tutorials
  • Suite Sandbox
  • Beta Program
  • Webex Status API
  • XML API Deprecation

Webex Meetings

Authorization

Authorization and device registration are important first steps in starting a meeting using the Web SDK. This document helps in using SDK for authenticating a user and registering the device with the Webex Meetings servers.

anchorInitialize the SDK

anchor

To use the SDK, you'll need a free Webex account; if you don't have a Cisco Webex account, visit Cisco Webex for Developers to create your account and retrieve your access token from Getting and Using your Personal Access Token.

To create a new Webex instance:

const webex = Webex.init({
    credentials: {  
       access_token: `<AUTHORIZATION/BOT TOKEN>`
    }
});

At this point, the Webex Meetings object is ready for use. The Meetings object contains a list of meetings as well as methods to perform specific operations or listen for certain events. Detailed information is included in this article.

For more information on the Meetings object, see Webex Messaging documentation.

anchorRetrieve a Meeting Object

anchor

The Meetings object is accessible from the Webex object:

const webex = new Webex.init();
const meetings = webex.meetings;

The meetings constant contains an instance of the Webex Meetings object.

anchorRegister a Meeting Device

anchor

Once the Meetings object is instantiated, you can register a device using its register() method:

const webex = new Webex.init();
await webex.meetings.register();

AsynchronousYes
ParametersNo parameters required
ReturnsPromise<undefined>

anchorDeregister a Meeting Device

anchor

You can deregister a registered device using the Meetings object's unregister() method:

await webex.meetings.unregister();

anchorMeetings Ready Event

anchor

A ready event fires when a Meetings object is ready for use. A Meetings object instance is ready once the containing Webex object is ready, and all the Meetings object's instance parameters are set. You can subscribe to the ready event immediately following Webex.init:

webex.meetings.on('meetings:ready',() => {
 console.log('Meetings object is ready for device registration');
 // Register a new device...
});

The ready event returns no payload.

Make any Meetings object method calls only after receiving this event.

anchorMeetings Registered Event

anchor

The registered event is emitted by a Meetings object after you call the register() method:

webex.meetings.on('meetings:registered',() => {
 console.log('Meetings object is ready to perform other operations');
 // Perform meeting operations like create, sync, etc.
});
In This Article
  • Initialize the SDK
  • Retrieve a Meeting Object
  • Register a Meeting Device
  • Deregister a Meeting Device
  • Meetings Ready Event
  • Meetings Registered Event

Connect

Support

Developer Community

Developer Events

Contact Sales

Handy Links

Webex Ambassadors

Webex App Hub

Resources

Open Source Bot Starter Kits

Download Webex

DevNet Learning Labs

Terms of Service

Privacy Policy

Cookie Policy

Trademarks

© 2025 Cisco and/or its affiliates. All rights reserved.