action zoom_get_user_contacts {
  label: "List user's contacts"
  description: "A user under an organization’s Zoom account has internal users listed under Company Contacts in the Zoom Client. A Zoom user can also add another Zoom user as a [contact](https://support.zoom.us/hc/en-us/articles/115004055706-Managing-Contacts). Call this API to list all the contacts of a Zoom user. Zoom contacts are categorized into \"company contacts\" and \"external contacts\". You must specify the contact type in the `type` query parameter. If you do not specify, by default, the type will be set as company contact.\n\n<p style=\"background-color:#e1f5fe; color:#01579b; padding:8px\"> <b>Note: </b> This API only supports <b>user-managed</b> <a href=\"https://marketplace.zoom.us/docs/guides/getting-started/app-types/create-oauth-app\">OAuth app</a>.</p><br>\n\n**Scope**: `chat_contact:read`<br>\n\n **[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `Medium`"
  provider: zoom
  method: GET
  path: "/chat/users/me/contacts"
  encoding: json
  input: {
    type: "object"
    properties: {
      next_page_token: {
        type: "string"
      }
      page_size: {
        type: "integer"
      }
      type: {
        type: "string"
      }
    }
    additionalProperties: false
  }
  output: {
    type: "object"
    properties: {
      contacts: {
        type: "array"
        description: "The contacts object."
        items: {
          type: "object"
          properties: {
            email: {
              type: "string"
              format: "email"
              description: "Contact's email address."
            }
            first_name: {
              type: "string"
              description: "Contact's first name."
            }
            id: {
              type: "string"
              description: "Contact Id."
            }
            last_name: {
              type: "string"
              description: "Contact's last name."
            }
          }
        }
      }
      next_page_token: {
        type: "string"
        description: "The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes."
      }
      page_size: {
        type: "integer"
        description: "The number of records returned with a single API call.\nDefault value: 30."
      }
    }
  }
}