Error Codes

The Zoom API uses HTTP Status codes to reflect a successful or unsuccesful request. 2XX status codes represent a successful request, 4XX/5XX status codes represent an error took place. If you receive an error status code, check the body for an error code and message.

Status CodeDescriptionMost Likely Cause
2XXSuccessful Request
400Bad RequestInvalid/missing data
401UnauthorizedInvalid/missing credentials
403ForbiddenUser does not have permission or has not authorized shared access permissions.
404Not FoundThe resource doesn't exist; invalid or non-existent user ID, for example
409ConflictTrying to overwrite a resource, for example when creating a user with an email that already exists
429Too Many RequestsHit an API rate limit
4700Invalid Access TokenInvalid access token, does not contain scopes. The user is not authorized

Error response example

{
    "code": 300,
    "message": "Request Body should be a valid JSON object."
}

Error response when sending invalid fields

{
    "code": 300,
    "message": "Validation Failed.",
    "errors": [
        {
            "field": "user_info.email",
            "message": "Invalid field."
        },
        {
            "field": "user_info.type",
            "message": "Invalid field."
        }
    ]
}