Getting Started

Welcome to the Zoom Developer platform. Follow along to setup your developer account and make your first API call.

Setup your Developer account

Head over to the Zoom Marketplace and Sign In using your Zoom account. You can now go on and add apps to your account, and build user-level apps like OAuth apps or Chatbots.

To access account-level credentials (for JWT or SDK apps), you’ll need Developer privilege. If you’re an account owner/admin, you likely already have this permission. If you don’t have Developer permissions and, contact your account admin to set up Role Permissions.

Developer access to the Zoom API is available with no cost to Licensed members. New accounts receive a 90-day free trial to access the Zoom API.

Get an access token

To make calls to the Zoom API, requests need to be authorized by either a JSON Web Token (account-level) or an OAuth access token (user or account-level).

If you have Developer privilege, create a JWT app on the Marketplace by navigating to Develop > Build an App. In the App Credentials page of this app, you’ll see a sample JWT Token. Copy this over to use in the next section.

If you don’t have developer privilege or want to test user-level apps, you’ll need to walk through an OAuth flow. Create an OAuth app on the Marketplace, then build our sample OAuth Hello World app to retrieve an access token. Copy this token over to use in the next section.

For more information on account-level authorization, reference our guide to JSON Web Tokens. For user-level authorization, reference our guide to OAuth 2.0.

Make an API Call

With either a JSON Web Token or an OAuth access token, you can now make requests to the Zoom API. Here we’ll make a request for an individual user to the Zoom API at the endpoint: https://api.zoom.us/v2/users/{userId}.

In this request path, specify the user you would like to access (yourself), using either your email or userID (if you know it). Examples:

GET https://api.zoom.us/v2/users/jane.dev@devinc.com
GET https://api.zoom.us/v2/users/z8dsdsdsdsdCfp8uQ

Open up your terminal or an HTTP client like Postman to send a request to the Zoom API.

In your terminal, send the following curl request, substituting your token and userId:

curl \
	-H 'Accept: application/json' \
	-H "Authorization: Bearer {TOKEN}" \
	https://api.zoom.us/v2/users/{userId}

The response from this request for your user information will come back in JSON format:

{
    "id": "z8dsdsdsdsdCfp8uQ",
    "first_name": "Jane",
    "last_name": "Dev",
    "email": "jane.dev@devinc.com",
    "type": 2,
    "role_name": "Developer",
    "pmi": 000000000,
    "use_pmi": false,
    "personal_meeting_url": "https://zoom.us/j/6352635623323434343443",
    "timezone": "America/Los_Angeles",
    "verified": 1,
    "dept": "",
    "created_at": "2018-11-15T01:10:08Z",
    "last_login_time": "2019-09-13T21:08:52Z",
    "last_client_version": "4.4.55383.0716(android)",
    "pic_url": "https://randomuser.me/api/portraits/women/40.jpg",
    "host_key": "0000",
    "jid": "hghghfghdfghdfhgh@xmpp.zoom.us",
    "group_ids": [],
    "im_group_ids": [
        "CcSAAAAAAABBBVoQ"
    ],
    "account_id": "EAAAAAbbbbbCCCCHMA",
    "language": "en-US",
    "phone_country": "USA",
    "phone_number": "00000000",
    "status": "active"
}

Need help?

The first place to look is on our Developer Forum. If you can't find the answer or your request includes sensitive information, contact Developer Support.