Authentication

This guide covers initializing the CometChat Calls SDK and authenticating users in your React Native application.

Initialize CometChat Calls

The init() method initializes the SDK with your app credentials. Call this method once when your application starts, typically in your app’s entry point or a dedicated initialization module.

Init Settings

Pass a plain settings object with your app credentials to init():

Parameter	Type	Required	Description
`appId`	string	Yes	Your CometChat App ID
`region`	string	Yes	Your app region (`us`, `eu`, or `in`)
`authKey`	string	No	Your CometChat Auth Key. If passed during initialization, you do not need to pass it to methods such as `login()`

import { CometChatCalls } from '@cometchat/calls-sdk-react-native';

const appId = 'APP_ID'; // Replace with your App ID
const region = 'REGION'; // Replace with your Region ("us", "eu", or "in")
const authKey = 'AUTH_KEY'; // Optional. Required only if you want to call login() without passing an Auth Key

const callAppSettings = { appId, region, authKey };

const initResult = await CometChatCalls.init(callAppSettings);

if (initResult.success) {
  console.log('CometChat Calls SDK initialized successfully');
} else {
  console.error('CometChat Calls SDK initialization failed:', initResult.error);
}

After initialization, authenticate the user using one of the login methods. Use this method during development or when you manage authentication on the client side. If you passed authKey to init(), you can call login() with only the user UID. Otherwise, pass the Auth Key directly as login(uid, authKey).

const uid = 'USER_UID';

try {
  const user = await CometChatCalls.login(uid);
  console.log('Login successful:', user);
} catch (error) {
  console.error('Login failed:', error);
}

Parameter	Type	Required	Description
`uid`	string	Yes	The unique identifier of the user
`authKey`	string	No	Your CometChat Auth Key. Required only when it was not passed to `init()`

Never expose your Auth Key in production apps. Use Auth Tokens generated from your backend server instead.

For production apps, generate an Auth Token on your backend server and use it to authenticate:

const authToken = 'USER_AUTH_TOKEN'; // Token from your backend

try {
  const user = await CometChatCalls.loginWithAuthToken(authToken);
  console.log('Login successful:', user);
} catch (error) {
  console.error('Login failed:', error);
}

Parameter	Type	Required	Description
`authToken`	string	Yes	Auth token generated from your backend

Logout

Log out the current user when they sign out of your app:

try {
  const message = await CometChatCalls.logout();
  console.log('Logout successful:', message);
} catch (error) {
  console.error('Logout failed:', error);
}

Verify if a user is currently logged in:

const isLoggedIn = CometChatCalls.isUserLoggedIn();

if (isLoggedIn) {
  console.log('User is logged in');
} else {
  console.log('No user logged in');
}

Get Logged In User

Retrieve the currently logged-in user’s details:

const user = CometChatCalls.getLoggedInUser();

if (user) {
  console.log('Current user:', user.uid, user.name);
} else {
  console.log('No user logged in');
}

Get User Auth Token

Retrieve the auth token of the currently logged-in user:

const authToken = CometChatCalls.getUserAuthToken();

if (authToken) {
  console.log('User auth token:', authToken);
}

Monitor login state changes by adding a login listener:

const listenerId = 'unique_listener_id';

CometChatCalls.addLoginListener(listenerId, {
  onLoginSuccess: (user) => {
    console.log('User logged in:', user);
  },
  onLoginFailure: (error) => {
    console.error('Login failed:', error);
  },
  onLogoutSuccess: () => {
    console.log('User logged out');
  },
  onLogoutFailure: (error) => {
    console.error('Logout failed:', error);
  },
});

// Remove listener when no longer needed
CometChatCalls.removeLoginListener(listenerId);

Error Handling

The SDK throws structured errors with the following properties:

Property	Type	Description
`errorCode`	string	A unique error code
`errorDescription`	string	Human-readable error description

Common error codes:

Error Code	Description
`ERROR_SDK_NOT_INITIALIZED`	SDK not initialized. Call `init()` first
`ERROR_LOGIN_IN_PROGRESS`	A login operation is already in progress
`ERROR_INVALID_UID`	UID is empty or invalid
`ERROR_UID_WITH_SPACE`	UID contains spaces
`ERROR_API_KEY_NOT_FOUND`	Auth Key is empty
`ERROR_BLANK_AUTHTOKEN`	Auth token is empty
`ERROR_AUTHTOKEN_WITH_SPACE`	Auth token contains spaces
`ERROR_NO_USER_LOGGED_IN`	No user is currently logged in

Setup - Install and configure the SDK
Session Settings - Configure call settings
Join Session - Start your first call

Overview

Getting Started

Call Session

Features

Advanced

Migration Guide

Resources

Initialize CometChat Calls

Init Settings

Logout

Get Logged In User

Get User Auth Token

Error Handling

​Initialize CometChat Calls

​Init Settings

​Login

​Login with UID and Auth Key

​Login with Auth Token

​Logout

​Check Login Status

​Get Logged In User

​Get User Auth Token

​Login Listeners

​Error Handling

​Related Documentation

Initialize CometChat Calls

Init Settings

Login

Login with UID and Auth Key

Login with Auth Token

Logout

Check Login Status

Get Logged In User

Get User Auth Token

Login Listeners

Error Handling

Related Documentation