> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.es/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Retrieve meeting link slug
> Obtén información detallada de una reserva para un enlace de reunión específico usando su slug. Este punto de terminación proporciona información sobre la disponibilidad y la configuración asociadas con el enlace de la reunión. Es útil para entender el contexto de la reserva y asegurarte de que se aplique la zona horaria correcta.
export const ScopesList = ({scopes = [], description = "Esta API requiere uno de los siguientes ámbitos:"}) => {
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/book/{slug}
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/book/{slug}:
get:
tags:
- Basic
summary: Obtener información de reserva
description: >-
Obtén información detallada de una reserva para un enlace de reunión
específico usando su slug. Este punto de terminación proporciona
información sobre la disponibilidad y la configuración asociadas con el
enlace de la reunión. Es útil para entender el contexto de la reserva y
asegurarte de que se aplique la zona horaria correcta.
operationId: get-/scheduler/2026-03/meetings/meeting-links/book/{slug}
parameters:
- name: slug
in: path
description: >-
El identificador único del enlace de reunión para el que se obtendrá
la información de la reserva.
required: true
style: simple
explode: false
schema:
type: string
- name: timezone
in: query
description: >-
La zona horaria que se usará para el enlace de la reunión. Esto es
necesario para asegurar el contexto de programación correcto.
required: true
style: form
explode: true
schema:
type: string
responses:
'200':
description: successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/ExternalBookingInfo'
default:
$ref: '#/components/responses/Error'
description: ''
security:
- oauth2:
- scheduler.meetings.meeting-link.read
components:
schemas:
ExternalBookingInfo:
required:
- allUsersBusyTimes
- customParams
- isOffline
- linkId
- linkType
type: object
properties:
allUsersBusyTimes:
type: array
description: >-
Un conjunto de objetos que representa los horarios ocupados de todos
los usuarios asociados con el enlace de la reunión.
items:
$ref: '#/components/schemas/ExternalUserBusyTimes'
brandingMetadata:
$ref: '#/components/schemas/ExternalBrandingMetadata'
customParams:
$ref: '#/components/schemas/ExternalMeetingsLinkSettings'
isOffline:
type: boolean
description: Un booleano que indica si el enlace de la reunión está offline.
linkAvailability:
$ref: '#/components/schemas/ExternalLinkAvailability'
linkId:
type: string
description: El identificador único del enlace de la reunión.
linkType:
type: string
description: >-
El tipo de enlace de reunión. Los valores válidos son
"PERSONAL_LINK", "GROUP_CALENDAR" y "ROUND_ROBIN_CALENDAR".
enum:
- GROUP_CALENDAR
- PERSONAL_LINK
- ROUND_ROBIN_CALENDAR
ExternalUserBusyTimes:
required:
- busyTimes
- isOffline
- meetingsUser
type: object
properties:
busyTimes:
type: array
description: >-
Una conjunto de intervalos de tiempo durante los cuales el usuario
está ocupado. Cada intervalo de tiempo se representa mediante un
objeto con horas de inicio y fin.
items:
$ref: '#/components/schemas/ExternalTimeRange'
isOffline:
type: boolean
description: Un booleano que indica si el usuario está offline.
meetingsUser:
$ref: '#/components/schemas/ExternalMeetingsUser'
ExternalBrandingMetadata:
required:
- logoAltText
- showMarketingAd
- showSalesAd
type: object
properties:
accent2Color:
type: string
description: >-
El segundo color de contraste usado para el branding, representado
como una cadena.
accentColor:
type: string
description: >-
El color de contraste que se usa para el branding, representado como
una cadena.
companyAddressLine1:
type: string
description: La primera línea de la dirección de la empresa.
companyAddressLine2:
type: string
description: La segunda línea de la dirección de la empresa, si corresponde.
companyAvatar:
type: string
description: La URL de la imagen del avatar de la empresa.
companyCity:
type: string
description: La ciudad donde se encuentra la empresa.
companyCountry:
type: string
description: El país donde se encuentra la empresa.
companyDomain:
type: string
description: El dominio de la empresa, que normalmente se usa en las URL.
companyName:
type: string
description: El nombre de la empresa.
companyState:
type: string
description: El estado o la región donde se encuentra la empresa.
companyZip:
type: string
description: El código postal de la ubicación de la empresa.
logoAltText:
type: string
description: >-
El texto alternativo del logo de la empresa, usado para
accesibilidad.
logoHeight:
type: integer
description: La altura del logo de la empresa en píxeles.
format: int32
logoUrl:
type: string
description: La URL de la imagen del logo de la empresa.
logoWidth:
type: integer
description: La anchura del logo de la empresa en píxeles.
format: int32
primaryColor:
type: string
description: >-
El color principal usado para el branding, representado como una
cadena.
secondaryColor:
type: string
description: >-
El color secundario que se usa para el branding, representado como
una cadena.
showMarketingAd:
type: boolean
description: >-
Indica si se debe mostrar un anuncio de marketing. Este es un valor
booleano.
showSalesAd:
type: boolean
description: >-
Indica si se debe mostrar un anuncio de ventas. Este es un valor
booleano.
ExternalMeetingsLinkSettings:
required:
- availability
- durations
- formFields
- legalConsentEnabled
- meetingBufferTime
- ownerPrioritized
- startTimeIncrementMinutes
- weeksToAdvertise
type: object
properties:
availability:
type: object
additionalProperties:
$ref: '#/components/schemas/ExternalClosedRange'
description: >-
Un objeto que representa la configuración de disponibilidad para el
enlace de la reunión, con propiedades adicionales para rangos
cerrados.
customAvailabilityEndDate:
type: integer
description: >-
Un número entero que representa la fecha de finalización de la
disponibilidad personalizada como una marca de tiempo Unix en
milisegundos.
format: int64
customAvailabilityStartDate:
type: integer
description: >-
Un número entero que representa la fecha de inicio de la
disponibilidad personalizada como una marca de tiempo Unix en
milisegundos.
format: int64
displayInfo:
$ref: '#/components/schemas/ExternalLinkDisplayInfo'
durations:
type: array
description: >-
Un conjunto de números enteros que representan las posibles
duraciones de las reuniones en milisegundos.
items:
type: integer
format: int64
formFields:
type: array
description: >-
Una lista de campos de formulario que se incluyen en el formulario
del enlace de la reunión.
items:
$ref: '#/components/schemas/ExternalLinkFormField'
guestSettings:
$ref: '#/components/schemas/ExternalGuestSettings'
language:
type: string
description: >-
Una cadena que representa la configuración de idioma para el enlace
de la reunión.
legalConsentEnabled:
type: boolean
description: >-
Un booleano que indica si se requiere consentimiento legal para el
enlace de la reunión.
legalConsentOptions:
$ref: '#/components/schemas/ExternalLegalConsentOptions'
locale:
type: string
description: >-
Una cadena que representa la configuración regional del enlace de
reunión.
location:
type: string
description: Una cadena que representa la información de ubicación de la reunión.
meetingBufferTime:
type: integer
description: >-
Un número entero que representa el margen de tiempo entre reuniones
en milisegundos.
format: int64
ownerPrioritized:
type: boolean
description: >-
Un booleano que indica si el propietario de la reunión tiene
prioridad en la programación.
redirectUrl:
type: string
description: >-
Una cadena que representa la URL a la que se redirecciona a los
usuarios después de programar una reunión.
startTimeIncrementMinutes:
type: string
description: >-
Una cadena que indica el incremento de las horas de inicio, con los
siguientes valores válidos: "MEETING_DURATION", "FIVE", "TEN",
"FIFTEEN", "TWENTY", "THIRTY", "FORTY_FIVE", "SIXTY", "NINETY" y
"ONE_HUNDRED_TWENTY".
enum:
- FIFTEEN
- FIVE
- FORTY_FIVE
- MEETING_DURATION
- NINETY
- ONE_HUNDRED_TWENTY
- SIXTY
- TEN
- THIRTY
- TWENTY
weeksToAdvertise:
type: integer
description: >-
Un número entero que representa la cantidad de semanas para anunciar
el enlace de la reunión.
format: int32
welcomeScreenInfo:
$ref: '#/components/schemas/ExternalMeetingsWelcomeScreenInfo'
ExternalLinkAvailability:
required:
- hasMore
- linkAvailabilityByDuration
type: object
properties:
hasMore:
type: boolean
description: >-
Un booleano que indica si hay más horarios de reunión disponibles
además de los proporcionados actualmente.
linkAvailabilityByDuration:
type: object
additionalProperties:
$ref: '#/components/schemas/ExternalLinkAvailabilityForDuration'
description: >-
Un objeto en el que cada clave es una duración y el valor es un
objeto de disponibilidad para esa duración. Este proporciona
información detallada de disponibilidad para cada duración de
reunión especificada.
Error:
required:
- category
- correlationId
- message
type: object
properties:
category:
type: string
description: La categoría del error. Es una cadena.
context:
type: object
additionalProperties:
type: array
items:
type: string
description: >-
Contexto sobre la condición del error. Es un objeto donde cada
propiedad es un conjunto de cadenas.
example: >-
{invalidPropertyName=[propertyValue], missingScopes=[scope1,
scope2]}
correlationId:
type: string
description: >-
Un identificador único para la solicitud. Incluye este valor en
cualquier informe de error o ticket de asistencia. Es una cadena en
formato UUID.
format: uuid
example: aeb5f871-7f07-4993-9211-075dc63e7cbf
errors:
type: array
description: >-
Más información sobre el error. Es un conjunto de objetos
ErrorDetail.
items:
$ref: '#/components/schemas/ErrorDetail'
links:
type: object
additionalProperties:
type: string
description: >-
Un mapa de nombres de enlaces con URI asociados que contienen
documentación sobre el error o los pasos de solución recomendados.
Es un objeto donde cada propiedad es una cadena.
message:
type: string
description: >-
Un mensaje legible que describe el error, junto con los pasos de
solución cuando corresponda. Es una cadena.
example: An error occurred
subCategory:
type: string
description: >-
Una categoría específica que contiene detalles más concretos acerca
del error. Es una cadena.
description: >-
Representa una respuesta de error que devuelve la API cuando una
operación falla. Este componente se usa en varios puntos de terminación
para dar información detallada sobre el error que se encontró.
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
ExternalTimeRange:
required:
- end
- start
type: object
properties:
end:
type: integer
description: >-
El final del peiodo, representado como un número entero en formato
int64.
format: int64
start:
type: integer
description: >-
El inicio del periodo, representado como un número entero en formato
int64.
format: int64
ExternalMeetingsUser:
required:
- calendarProvider
- id
- isSalesStarter
- userId
- userProfile
type: object
properties:
calendarProvider:
type: string
description: >-
El proveedor de servicios de calendario que emplea el usuario. Los
valores válidos son "GOOGLE", "OFFICE365", "EXCHANGE" y "UNKNOWN".
enum:
- EXCHANGE
- GOOGLE
- OFFICE365
- UNKNOWN
id:
type: string
description: El identificador único para el usuario de reunión.
isSalesStarter:
type: boolean
description: Un booleano que indica si el usuario tiene Sales Hub Starter.
userId:
type: string
description: >-
El identificador único del usuario asociado al servicio de
reuniones.
userProfile:
$ref: '#/components/schemas/ExternalUserProfile'
ExternalClosedRange:
required:
- end
- start
type: object
properties:
end:
type: integer
description: >-
El punto final del intervalo, representado como un número entero en
formato int64.
format: int64
start:
type: integer
description: >-
El punto de inicio del intervalo, representado como un número entero
en formato int64.
format: int64
ExternalLinkDisplayInfo:
type: object
properties:
avatar:
type: string
description: >-
Una cadena que representa la URL de la imagen del avatar que se
mostrará.
companyAvatar:
type: string
description: >-
Una cadena que representa la URL de la imagen que se mostrará del
avatar de la empresa.
headline:
type: string
description: >-
Una cadena que representa el texto del título que se mostrará con el
enlace de la reunión.
publicDisplayAvatarOption:
type: string
description: >-
Una cadena que indica la opción de visualización del avatar, con los
siguientes valores válidos: "PROFILE_IMAGE", "COMPANY_LOGO" y
"CUSTOM_AVATAR".
enum:
- COMPANY_LOGO
- CUSTOM_AVATAR
- PROFILE_IMAGE
ExternalLinkFormField:
required:
- fieldType
- isCustom
- isRequired
- label
- name
- options
- type
type: object
properties:
fieldType:
type: string
description: >-
El tipo de campo del formulario, representado como una cadena, que
indica el tipo de entrada esperada.
isCustom:
type: boolean
description: >-
Un booleano que indica si el campo del formulario es un campo
personalizado definido por el usuario.
isRequired:
type: boolean
description: >-
Un booleano que indica si el campo del formulario es obligatorio
para el usuario.
label:
type: string
description: >-
La etiqueta del campo del formulario que se muestra a los usuarios,
en formato de cadena.
name:
type: string
description: >-
El identificador de nombre único del campo del formulario,
representado como una cadena.
options:
type: array
description: >-
Una serie de opciones disponibles para el campo del formulario,
aplicable si el tipo de campo admite múltiples opciones.
items:
$ref: '#/components/schemas/ExternalOption'
type:
type: string
description: >-
El tipo de datos específico del campo de formulario, representado
como una cadena.
ExternalGuestSettings:
required:
- canAddGuests
- maxGuestCount
type: object
properties:
canAddGuests:
type: boolean
description: Un booleano que indica si se pueden añadir invitados a la reunión.
maxGuestCount:
type: integer
description: >-
Un número entero que especifica el número máximo de invitados que se
pueden añadir a la reunión.
format: int32
ExternalLegalConsentOptions:
required:
- communicationConsentCheckboxes
- communicationConsentText
- isLegitimateInterest
- legitimateInterestSubscriptionTypes
- privacyPolicyText
- processingConsentCheckboxLabel
- processingConsentFooterText
- processingConsentText
- processingConsentType
type: object
properties:
communicationConsentCheckboxes:
type: array
description: >-
Un conjunto de casillas de verificación de consentimiento de
comunicación, cada una definida por un objeto
ExternalCommunicationConsentCheckbox.
items:
$ref: '#/components/schemas/ExternalCommunicationConsentCheckbox'
communicationConsentText:
type: string
description: >-
Una cadena que contiene el texto para el consentimiento a las
comunicaciones.
isLegitimateInterest:
type: boolean
description: Un booleano que indica si el interés legítimo es aplicable.
legitimateInterestLegalBasis:
type: string
description: >-
Una cadena que indica la base legal para el interés legítimo. Los
valores válidos son "LEGITIMATE_INTEREST_PQL",
"LEGITIMATE_INTEREST_CLIENT", "PERFORMANCE_OF_CONTRACT",
"CONSENT_WITH_NOTICE", "NON_GDPR", "PROCESS_AND_STORE" y
"LEGITIMATE_INTEREST_OTHER".
enum:
- CONSENT_WITH_NOTICE
- LEGITIMATE_INTEREST_CLIENT
- LEGITIMATE_INTEREST_OTHER
- LEGITIMATE_INTEREST_PQL
- NON_GDPR
- PERFORMANCE_OF_CONTRACT
- PROCESS_AND_STORE
legitimateInterestSubscriptionTypes:
type: array
description: >-
Un conjunto de números enteros que representan los tipos de
suscripciones que entran dentro del interés legítimo.
items:
type: integer
format: int64
privacyPolicyText:
type: string
description: Una cadena que contiene el texto de la política de privacidad.
processingConsentCheckboxLabel:
type: string
description: >-
Una cadena que representa la etiqueta de la casilla de verificación
de consentimiento al tratamiento de datos.
processingConsentFooterText:
type: string
description: >-
Una cadena que contiene el texto del pie de página del
consentimiento al tratamiento de datos.
processingConsentText:
type: string
description: >-
Una cadena que contiene el texto del consentimiento al tratamiento
de datos.
processingConsentType:
type: string
description: >-
Una cadena que indica el tipo de consentimiento al tratamiento de
datos. Los valores válidos son "IMPLICIT" y "REQUIRED_CHECKBOX".
enum:
- IMPLICIT
- REQUIRED_CHECKBOX
ExternalMeetingsWelcomeScreenInfo:
type: object
properties:
description:
type: string
description: >-
Un texto descriptivo que se muestra en la pantalla de bienvenida. Es
un valor de cadena.
logoUrl:
type: string
description: >-
La URL de la imagen del logo que se muestra en la pantalla de
bienvenida. Es un valor de cadena.
showWelcomeScreen:
type: boolean
description: >-
Un booleano que indica si la pantalla de bienvenida debe mostrarse a
los usuarios.
title:
type: string
description: >-
El título que se muestra en la pantalla de bienvenida. Es un valor
de cadena.
useCompanyLogo:
type: boolean
description: >-
Un booleano que indica si el logo de la empresa debe usarse en la
pantalla de bienvenida.
ExternalLinkAvailabilityForDuration:
required:
- availabilities
- meetingDurationMillis
type: object
properties:
availabilities:
type: array
description: >-
Un conjunto de franjas horarias disponibles para la duración de la
reunión especificada. Cada elemento del conjunto es un objeto que
representa las horas de inicio y fin de una franja horaria.
items:
$ref: '#/components/schemas/ExternalMeetingAvailability'
meetingDurationMillis:
type: integer
description: >-
La duración de la reunión en milisegundos. Es un valor entero que
representa la duración de la reunión.
format: int64
ErrorDetail:
required:
- message
type: object
properties:
code:
type: string
description: El código de estado asociado al detalle del error.
context:
type: object
additionalProperties:
type: array
items:
type: string
description: >-
Contexto sobre la condición del error, representado como un objeto
donde cada propiedad es un conjunto de cadenas que proporcionan
información adicional.
example: '{missingScopes=[scope1, scope2]}'
in:
type: string
description: El nombre del campo o parámetro en el que se encontró el error.
message:
type: string
description: >-
Un mensaje legible que describe el error, junto con los pasos de
solución cuando corresponda. Este es un campo obligatorio.
subCategory:
type: string
description: >-
Una categoría específica que contiene detalles más concretos acerca
del error.
description: >-
Representa información detallada sobre un error que ocurrió en la API.
Este componente se usa para dar contexto adicional y detalles
específicos sobre los errores, normalmente como parte de una respuesta
de error.
ExternalUserProfile:
required:
- email
type: object
properties:
email:
type: string
description: >-
La dirección de correo electrónico del usuario. Esta es una
propiedad de cadena obligatoria.
firstName:
type: string
description: El nombre del usuario. Es una cadena.
fullName:
type: string
description: >-
El nombre completo del usuario, que combina el nombre y los
apellidos. Es una cadena.
lastName:
type: string
description: El apellido del usuario. Es una cadena.
ExternalOption:
required:
- description
- displayOrder
- doubleData
- hidden
- label
- readOnly
- value
type: object
properties:
description:
type: string
description: Una cadena que proporciona una descripción detallada de la opción.
displayOrder:
type: integer
description: >-
Un número entero que indica el orden en que la opción debe mostrarse
en relación con otras opciones.
format: int32
doubleData:
type: number
description: >-
Un número que puede contener datos adicionales asociados con la
opción.
hidden:
type: boolean
description: Un booleano que indica si la opción está oculta de la visualización.
label:
type: string
description: Una cadena que representa el nombre visible de la opción.
readOnly:
type: boolean
description: >-
Un booleano que indica si la opción es de solo lectura y no se puede
modificar.
value:
type: string
description: Una cadena que representa el valor interno asociado a la opción.
ExternalCommunicationConsentCheckbox:
required:
- communicationTypeId
- label
- required
type: object
properties:
communicationTypeId:
type: string
description: >-
Una cadena que representa el identificador único del tipo de
comunicación al que pertenece esta casilla de verificación.
label:
type: string
description: >-
Una cadena que contiene la etiqueta de texto que se muestra junto a
la casilla de verificación y que describe el tipo o propósito de la
comunicación.
required:
type: boolean
description: >-
Un booleano que indica si el usuario debe marcar esta casilla de
verificación para continuar, lo que significa un consentimiento
obligatorio.
ExternalMeetingAvailability:
required:
- endMillisUtc
- startMillisUtc
type: object
properties:
endMillisUtc:
type: integer
description: >-
La hora de finalización de la disponibilidad para la reunión,
representada como una marca de tiempo Unix en milisegundos.
format: int64
startMillisUtc:
type: integer
description: >-
La hora de inicio de la disponibilidad de la reunión, representada
como una marca de tiempo Unix en milisegundos.
format: int64
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}
)}