Saltar al contenido principal
POST
/
scheduler
/
v3
/
meetings
/
meeting-links
/
book
Reservar una reunión
curl --request POST \
  --url https://api.hubapi.com/scheduler/v3/meetings/meeting-links/book \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "duration": 123,
  "email": "<string>",
  "firstName": "<string>",
  "formFields": [
    {
      "name": "<string>",
      "value": "<string>"
    }
  ],
  "lastName": "<string>",
  "legalConsentResponses": [
    {
      "communicationTypeId": "<string>",
      "consented": true
    }
  ],
  "likelyAvailableUserIds": [
    "<string>"
  ],
  "slug": "<string>",
  "startTime": "2023-11-07T05:31:56Z",
  "locale": "<string>",
  "timezone": "<string>"
}
'
{
  "bookingTimezone": "<string>",
  "calendarEventId": "<string>",
  "contactId": "<string>",
  "duration": 123,
  "end": "2023-11-07T05:31:56Z",
  "formFields": [
    {
      "isCustom": true,
      "label": "<string>",
      "name": "<string>",
      "value": "<string>",
      "fieldType": "<string>",
      "translatedLabel": "<string>",
      "valueLabel": "<string>"
    }
  ],
  "guestEmails": [
    "<string>"
  ],
  "isOffline": true,
  "legalConsentResponses": [
    {
      "communicationTypeId": "<string>",
      "consented": true
    }
  ],
  "start": "2023-11-07T05:31:56Z",
  "subject": "<string>",
  "locale": "<string>",
  "location": "<string>",
  "webConferenceMeetingId": "<string>",
  "webConferenceUrl": "<string>"
}

Productos compatibles

Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing Hub -Gratuito
Sales HubSales Hub -Gratuito
Service HubService Hub -Gratuito
Content HubContent Hub -Gratuito

Autorizaciones

Authorization
string
header
requerido

The access token received from the authorization server in the OAuth 2.0 flow.

Cuerpo

application/json
duration
integer<int64>
requerido

La duración de la reunión en milisegundos.

email
string
requerido

La dirección de correo electrónico de la persona que programa la reunión.

firstName
string
requerido

El nombre de la persona que programa la reunión.

formFields
object[]
requerido
lastName
string
requerido

Los apellidos de la persona que programa la reunión.

likelyAvailableUserIds
string[]
requerido
slug
string
requerido

El identificador único de la ruta de la página de la reunión.

startTime
string<date-time>
requerido

La fecha y hora en que está previsto que comience la reunión, en formato ISO 8601.

locale
string

La configuración regional utilizada para dar formato a las fechas y horas en la programación de la reunión.

timezone
string

La zona horaria en la que se programa la reunión.

Respuesta

successful operation

bookingTimezone
string
requerido

La zona horaria desde la que se programó la reunión.

calendarEventId
string
requerido

El identificador único del evento del calendario de la reunión.

contactId
string
requerido

El ID del contacto asociado a la reunión.

duration
integer<int64>
requerido

La duración de la reunión en milisegundos.

end
string<date-time>
requerido

La fecha y hora en que está previsto que finalice la reunión, en formato ISO 8601.

formFields
object[]
requerido
guestEmails
string[]
requerido
isOffline
boolean
requerido

Si la reunión se programó offline y no se creó ningún evento de calendario asociado.

start
string<date-time>
requerido

La fecha y hora en que está previsto que comience la reunión, en formato ISO 8601.

subject
string
requerido

El título de la reunión y del evento del calendario.

locale
string

La configuración regional con la que se reservó la reunión, utilizada para determinar el formato de fecha en la descripción del evento del calendario.

location
string

El lugar físico o virtual donde se llevará a cabo la reunión.

webConferenceMeetingId
string

El identificador único de la reunión de conferencia web.

webConferenceUrl
string

La URL para acceder a la conferencia web de la reunión.

Last modified on March 30, 2026