---
title: "List meeting links"
method: GET
path: "/scheduler/2027-03-beta/meetings/meeting-links"
tags: ["Basic"]
---

# List meeting links

`GET /scheduler/2027-03-beta/meetings/meeting-links`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/scheduler/2027-03-beta/meetings/meeting-links`
- Auth: OAuth 2
  - Authorization code: `https://app.hubspot.com/oauth/authorize`
  - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `scheduler.meetings.meeting-link.read`

Retrieve a list of meeting links available in your HubSpot account. This endpoint allows you to filter the results by various criteria such as the organizer's user ID, meeting type, and name. It supports pagination to help manage large sets of data.

## Query parameters

- `after` string
- `limit` integer
- `name` string
- `organizerUserId` string
- `type` 'GROUP_CALENDAR' | 'PERSONAL_LINK' | 'ROUND_ROBIN_CALENDAR'

## Response `200`

successful operation

- CollectionResponseWithTotalExternalLinkMetadata
  - `paging` Paging: Represents the pagination information for navigating through a list of results in the API. It provides details on how to access the previous or next set of results.
    - `next` NextPage: Specifies the paging information needed to retrieve the next set of results in a paginated API response
      - `after` string, required: A string token that indicates the position after the last item on the current page, used to retrieve the next page of results.
      - `link` string: A string URL that provides a direct link to access the next page of results.
    - `prev` PreviousPage: specifies the paging information needed to retrieve the previous set of results in a paginated API response
      - `before` string, required: A string token used to identify the cursor position before the current page in a paginated response.
      - `link` string: A URL string that provides a direct link to the previous page of results.
  - `results` ExternalLinkMetadata[], required: An array of ExternalLinkMetadata objects, each containing details about a specific external link.
    - `createdAt` string, date-time, required: The date and time when the meeting link was created, in ISO 8601 format.
    - `defaultLink` boolean, required: A boolean indicating whether this is the default meeting link.
    - `id` string, required: The unique identifier for the meeting link.
    - `link` string, required: The URL of the meeting link.
    - `name` string: The name of the meeting link.
    - `organizerUserId` string, required: The unique identifier of the user who organized the meeting link.
    - `paymentLinkId` string: The unique identifier for the payment link associated with the meeting, if any.
    - `slug` string, required: A string used to uniquely identify the meeting link in URLs.
    - `type` 'GROUP_CALENDAR' | 'PERSONAL_LINK' | 'ROUND_ROBIN_CALENDAR', required: The type of meeting link. Valid values include 'PERSONAL_LINK', 'GROUP_CALENDAR', and 'ROUND_ROBIN_CALENDAR'.
    - `updatedAt` string, date-time: The date and time when the meeting link was last updated, in ISO 8601 format.
    - `userIdsOfLinkMembers` string[], required: An array of user IDs who are members of the meeting link.
  - `total` integer, required: An integer representing the total number of external link metadata entries available.

## Other responses

- `default`: An error occurred.

---

[API](https://skmtc.dev/hubspot/apis/scheduler-meetings.md) - [All operations](https://skmtc.dev/hubspot/apis/scheduler-meetings/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/scheduler-meetings/revisions/6d3443ad681b?raw)