> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
---
id: bb49775c-53ea-422b-a443-ed99369aa6e0
---
# Retrieve meeting scheduling pages
> Retrieve a list of meeting links available in the HubSpot account. This endpoint allows filtering by various criteria such as meeting name, organizer user ID, and meeting type. It supports pagination to navigate through large sets of results.
export const ScopesList = ({scopes = [], description = "This API requires one of the following scopes:"}) => {
if (!scopes || scopes.length === 0) {
return null;
}
const sortedScopes = scopes.sort((a, b) => a.localeCompare(b));
return
;
};
## OpenAPI
````yaml specs/2026-03/scheduler-meetings-v2026-03.json GET /scheduler/2026-03/meetings/meeting-links
openapi: 3.0.1
info:
title: Scheduler Meetings
description: Meetings Service For HubSpot Sales
version: 2026-03
x-hubspot-product-tier-requirements:
marketing: FREE
sales: FREE
service: FREE
cms: FREE
commerce: FREE
crmHub: FREE
dataHub: FREE
servers:
- url: https://api.hubapi.com
security: []
tags:
- name: Advanced
- name: Basic
paths:
/scheduler/2026-03/meetings/meeting-links:
get:
tags:
- Basic
summary: List Meeting Links
description: >-
Retrieve a list of meeting links available in the HubSpot account. This
endpoint allows filtering by various criteria such as meeting name,
organizer user ID, and meeting type. It supports pagination to navigate
through large sets of results.
operationId: get-/scheduler/2026-03/meetings/meeting-links
parameters:
- name: after
in: query
description: >-
The paging cursor token of the last successfully read resource, used
for pagination.
required: false
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: The maximum number of results to display per page.
required: false
style: form
explode: true
schema:
type: integer
format: int32
- name: name
in: query
description: Filter meeting links by name.
required: false
style: form
explode: true
schema:
type: string
- name: organizerUserId
in: query
description: Filter meeting links by the organizer's user ID.
required: false
style: form
explode: true
schema:
type: string
- name: type
in: query
description: >-
Filter meeting links by type. Valid values are PERSONAL_LINK,
GROUP_CALENDAR, and ROUND_ROBIN_CALENDAR.
required: false
style: form
explode: true
schema:
type: string
enum:
- GROUP_CALENDAR
- PERSONAL_LINK
- ROUND_ROBIN_CALENDAR
responses:
'200':
description: successful operation
content:
application/json:
schema:
$ref: >-
#/components/schemas/CollectionResponseWithTotalExternalLinkMetadata
default:
$ref: '#/components/responses/Error'
description: ''
security:
- oauth2:
- scheduler.meetings.meeting-link.read
components:
schemas:
CollectionResponseWithTotalExternalLinkMetadata:
required:
- results
- total
type: object
properties:
paging:
$ref: '#/components/schemas/Paging'
results:
type: array
description: >-
An array of external link metadata objects. Each object contains
details about an external meeting link.
items:
$ref: '#/components/schemas/ExternalLinkMetadata'
total:
type: integer
description: >-
The total number of external link metadata entries available. This
is an integer value.
format: int32
Paging:
type: object
properties:
next:
$ref: '#/components/schemas/NextPage'
prev:
$ref: '#/components/schemas/PreviousPage'
ExternalLinkMetadata:
required:
- createdAt
- defaultLink
- id
- link
- organizerUserId
- slug
- type
- userIdsOfLinkMembers
type: object
properties:
createdAt:
type: string
description: >-
The date and time when the meeting link was created, in ISO 8601
format.
format: date-time
defaultLink:
type: boolean
description: A boolean indicating whether this is the default meeting link.
id:
type: string
description: The unique identifier for the meeting link.
link:
type: string
description: The full URL of the meeting link.
name:
type: string
description: The name of the meeting link.
organizerUserId:
type: string
description: The unique identifier of the user who organized the meeting.
paymentLinkId:
type: string
description: >-
An integer representing the identifier for the payment link
associated with the meeting.
slug:
type: string
description: >-
A string representing the unique part of the URL for the meeting
link.
type:
type: string
description: >-
The type of meeting link. Valid values include 'PERSONAL_LINK',
'GROUP_CALENDAR', and 'ROUND_ROBIN_CALENDAR'.
enum:
- GROUP_CALENDAR
- PERSONAL_LINK
- ROUND_ROBIN_CALENDAR
updatedAt:
type: string
description: >-
The date and time when the meeting link was last updated, in ISO
8601 format.
format: date-time
userIdsOfLinkMembers:
type: array
description: >-
An array of user IDs representing the members associated with the
meeting link.
items:
type: string
Error:
required:
- category
- correlationId
- message
type: object
properties:
category:
type: string
description: The error category. It is a string.
context:
type: object
additionalProperties:
type: array
items:
type: string
description: >-
Context about the error condition. It is an object where each
property is an array of strings.
example: >-
{invalidPropertyName=[propertyValue], missingScopes=[scope1,
scope2]}
correlationId:
type: string
description: >-
A unique identifier for the request. Include this value with any
error reports or support tickets. It is a string in UUID format.
format: uuid
example: aeb5f871-7f07-4993-9211-075dc63e7cbf
errors:
type: array
description: >-
Further information about the error. It is an array of ErrorDetail
objects.
items:
$ref: '#/components/schemas/ErrorDetail'
links:
type: object
additionalProperties:
type: string
description: >-
A map of link names to associated URIs containing documentation
about the error or recommended remediation steps. It is an object
where each property is a string.
message:
type: string
description: >-
A human readable message describing the error along with remediation
steps where appropriate. It is a string.
example: An error occurred
subCategory:
type: string
description: >-
A specific category that contains more specific detail about the
error. It is a string.
description: >-
Represents an error response returned by the API when an operation
fails. This component is used in various endpoints to provide detailed
information about the error encountered.
example:
message: Invalid input (details will vary based on the error)
correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf
category: VALIDATION_ERROR
links:
knowledge-base: https://www.hubspot.com/products/service/knowledge-base
NextPage:
required:
- after
type: object
properties:
after:
type: string
description: >-
A string representing the paging cursor token for the next set of
results.
link:
type: string
description: A string containing the URL link to the next page of results.
description: >-
Specifies the paging information needed to retrieve the next set of
results in a paginated API response
PreviousPage:
required:
- before
type: object
properties:
before:
type: string
description: A string token used to retrieve the previous page of results.
link:
type: string
description: >-
A string URL that provides a direct link to the previous page of
results.
description: >-
specifies the paging information needed to retrieve the previous set of
results in a paginated API response
ErrorDetail:
required:
- message
type: object
properties:
code:
type: string
description: The status code associated with the error detail.
context:
type: object
additionalProperties:
type: array
items:
type: string
description: >-
Context about the error condition, represented as an object where
each property is an array of strings providing additional
information.
example: '{missingScopes=[scope1, scope2]}'
in:
type: string
description: The name of the field or parameter in which the error was found.
message:
type: string
description: >-
A human readable message describing the error along with remediation
steps where appropriate. This is a required field.
subCategory:
type: string
description: >-
A specific category that contains more specific detail about the
error.
description: >-
Represents detailed information about an error that occurred in the API.
This component is used to provide additional context and specifics about
errors, typically as part of an error response.
responses:
Error:
description: An error occurred.
content:
'*/*':
schema:
$ref: '#/components/schemas/Error'
securitySchemes:
oauth2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://app.hubspot.com/oauth/authorize
tokenUrl: https://api.hubapi.com/oauth/v1/token
scopes:
crm.objects.contacts.sensitive.write.v2: ''
crm.schemas.meetings.write: ''
scheduler.meetings.meeting-link.read: ''
````
{product.name} -
{product.level}
)}