Initiate an outbound call

Zoom supports various URI schemes that allow users to launch the Zoom Phone client by clicking a secure hyperlink or a button.

This guide provides you with an overview of the supported URI schemes that you can use to redirect your app users to the Zoom Phone client to make outbound calls.

Prerequisites

To use these schemes, the user (caller) must meet the following prerequisites:

Install the latest version of Zoom Client and stay logged in before initiating a call from another app.
Hold a valid Zoom Phone number.

Supported URI schemes

Zoom supports the following URI schemes that you can choose from to launch the Zoom Phone client and place calls.

a. zoomphonecall URI scheme

The zoomphonecall scheme is developed by Zoom. You can access this scheme by using the following URL:

zoomphonecall://{phoneNumbertoCall}?cat=seccall&token={jwttoken}

Note

The query parameters above are optional and you may be able to call without authentication: cat=seccall&token={jwttoken}. Token verification is enabled for Zoom client version 5.0.24978.0517 or higher.
The URI scheme is one way to launch the Zoom client. The client ultimately manages user authentication.
Upon successful execution, zoomphonecall://{phoneNumbertoCall} can auto-dial the number you entered.

Authentication

(Optional) You can generate a JWT token with the following format:

{
  "iss": "Enter your OAuth App Client ID.",
  "iat": "Enter the current epoch timestamp in seconds in long format. Note that the value of this field should not be a string.",
  "exp": "Enter the expiration timestamp for the JWT in seconds in long format. Note that the value of this field should not be a string.",
  "oid": "Enter the phone number to call. This value should match the number provided in the URI scheme.",
  "uid": "Enter the user ID of the user on whose behalf the call is to be placed. The user with this userId must be logged into the Zoom Client app using their Zoom account."
}

b. callto and tel URI schemes

The callto and tel URI schemes are popular industry standard schemes. You can use either of these schemes to launch the Zoom Phone client.

Implement the tel scheme by using the following URL format:

tel:{phoneNumberToCall}
Example: tel:+123456789

Similarly, you can implement the callto scheme by using the following URL format:

tel:{phoneNumberToCall}
Example: callto:+123456789

After clicking on a button or a hyperlink associated with the scheme, the user will be prompted to confirm whether or not you would like to open the Zoom app.

After confirming to open the app, the Zoom Phone tab is displayed. The phone number included in the scheme will be copied and displayed when the Zoom Phone client is opened via the scheme.

The user can click the call button to place the call.

Next Steps

Learn how you can get real-time call data using Webhooks.