> ## 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. # Create a new calendar event for a meeting > Crea un nuevo evento de reunión en tu cuenta de HubSpot. Este punto de terminación te permite especificar detalles como el título de la reunión, las horas de inicio y fin, y los usuarios asociados. El organizerUserId es necesario para identificar al organizador de la reunión. 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
{description}
{sortedScopes.map((scope, index) =>
{scope}
)}
; }; export const SupportedProducts = ({marketing, sales, service, cms, marketingLevel, salesLevel, serviceLevel, cmsLevel}) => { const translations = { header: "Productos compatibles", description: "Se requiere uno de los siguientes productos o productos de ediciones superiores.", productNames: { marketing: "Marketing Hub", sales: "Sales Hub", service: "Service Hub", cms: "Content Hub" }, tiers: { free: "Gratuito", starter: "Starter", professional: "Pro", enterprise: "Enterprise" } }; const translateTier = tier => { if (!tier) return ''; const lowerTier = tier.toLowerCase(); return translations.tiers[lowerTier] || tier; }; const products = [{ name: marketing ? translations.productNames.marketing : '', level: translateTier(marketingLevel), icon: "https://mintlify-assets.b-cdn.net/Icons/marketing-bolt.svg", alt: "Marketing Hub" }, { name: sales ? translations.productNames.sales : '', level: translateTier(salesLevel), icon: "https://mintlify-assets.b-cdn.net/Icons/sales-star.svg", alt: "Sales Hub" }, { name: service ? translations.productNames.service : '', level: translateTier(serviceLevel), icon: "https://mintlify-assets.b-cdn.net/Icons/service-heart.svg", alt: "Service Hub" }, { name: cms ? translations.productNames.cms : '', level: translateTier(cmsLevel), icon: "https://mintlify-assets.b-cdn.net/Icons/content-play.svg", alt: "Content Hub" }].filter(product => product.name && product.level); if (products.length === 0) return null; return
{translations.description}
{products.map((product, index) =>
{product.alt} {product.name} - {product.level}
)}
; }; ## OpenAPI ````yaml specs/2026-03/scheduler-meetings-v2026-03.json POST /scheduler/2026-03/meetings/calendar 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/calendar: post: tags: - Advanced summary: Crear reunión description: >- Crea un nuevo evento de reunión en tu cuenta de HubSpot. Este punto de terminación te permite especificar detalles como el título de la reunión, las horas de inicio y fin, y los usuarios asociados. El organizerUserId es necesario para identificar al organizador de la reunión. operationId: post-/scheduler/2026-03/meetings/calendar parameters: - name: organizerUserId in: query description: >- El identificador único del usuario que organiza la reunión. Este parámetro es obligatorio. required: true style: form explode: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/ExternalCalendarMeetingEventCreateRequest' required: true responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/ExternalCalenderMeetingEventResponse' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - crm.objects.contacts.highly_sensitive.write.v2 - oauth2: - tickets - oauth2: - crm.objects.commercepayments.write - oauth2: - crm.objects.goals.write - oauth2: - crm.objects.line_items.write - oauth2: - crm.objects.contacts.write - oauth2: - crm.objects.products.write - oauth2: - crm.objects.projects.write - oauth2: - crm.objects.contacts.sensitive.write.v2 - oauth2: - crm.objects.services.write - oauth2: - crm.objects.projects.sensitive.write - oauth2: - crm.objects.deals.sensitive.write.v2 - oauth2: - tickets.highly_sensitive.v2 - oauth2: - crm.objects.listings.write - oauth2: - crm.objects.appointments.sensitive.write.v2 - oauth2: - crm.objects.companies.write - oauth2: - crm.objects.courses.write - oauth2: - crm.objects.appointments.write - oauth2: - tickets.sensitive.v2 - oauth2: - crm.objects.deals.write - oauth2: - crm.objects.projects.highly_sensitive.write - oauth2: - crm.objects.companies.sensitive.write.v2 - oauth2: - crm.objects.deals.highly_sensitive.write.v2 - oauth2: - crm.objects.companies.highly_sensitive.write.v2 - oauth2: - crm.schemas.meetings.write components: schemas: ExternalCalendarMeetingEventCreateRequest: required: - associations - emailReminderSchedule - properties - timezone type: object properties: associations: type: array description: >- Un conjunto de asociaciones relacionadas con el evento de reunión, cada una representada por un objeto ExternalAssociationCreateRequest. items: $ref: '#/components/schemas/ExternalAssociationCreateRequest' emailReminderSchedule: $ref: '#/components/schemas/ExternalEmailReminderSchedule' properties: $ref: '#/components/schemas/ExternalCalendarMeetingEventCreateProperties' timezone: type: string description: >- Una cadena que representa la zona horaria en la que está programado el evento de reunión. ExternalCalenderMeetingEventResponse: required: - createdAt - id - lastUpdatedAt - properties type: object properties: createdAt: type: string description: >- La fecha y hora en que se creó el evento de reunión del calendario, en formato ISO 8601. format: date-time id: type: string description: El identificador único del evento de reunión del calendario. lastUpdatedAt: type: string description: >- La fecha y hora en que el evento de reunión del calendario se actualizó por última vez, en formato ISO 8601. format: date-time properties: $ref: '#/components/schemas/ExternalCalendarMeetingEventResponseProperties' ExternalAssociationCreateRequest: required: - to - types type: object properties: to: $ref: '#/components/schemas/PublicObjectId' types: type: array description: >- Un conjunto de especificaciones de asociaciones que detalla los tipos de asociaciones que se crearán. Cada elemento del conjunto es un objeto que define el tipo de asociación. items: $ref: '#/components/schemas/AssociationSpec' ExternalEmailReminderSchedule: required: - reminders - shouldIncludeInviteDescription type: object properties: reminders: type: array description: >- Un conjunto de objetos ExternalReminder que especifican la hora y la frecuencia de los recordatorios por correo electrónico. items: $ref: '#/components/schemas/ExternalReminder' shouldIncludeInviteDescription: type: boolean description: >- Un booleano que indica si la descripción de la invitación debe incluirse en el recordatorio por correo electrónico. ExternalCalendarMeetingEventCreateProperties: required: - hs_meeting_end_time - hs_meeting_outcome - hs_meeting_start_time - hs_meeting_title - hs_timestamp - hubspot_owner_id type: object properties: hs_activity_type: type: string description: El tipo de actividad para la reunión. Es un valor de cadena. hs_attachment_ids: type: array description: >- Un conjunto de cadenas que representan los ID de los archivos adjuntos asociados a la reunión. items: type: string hs_attendee_owner_ids: type: array description: >- Un conjunto de cadenas que representan los ID de los propietarios de los asistentes a la reunión. items: type: string hs_internal_meeting_notes: type: string description: Notas internas para la reunión. Este es un valor de cadena. hs_meeting_body: type: string description: El contenido o la descripción de la reunión. Es un valor de cadena. hs_meeting_end_time: type: string description: La hora de finalización de la reunión, en formato ISO 8601. format: date-time hs_meeting_location: type: string description: La ubicación de la reunión. Es un valor de cadena. hs_meeting_location_type: type: string description: >- El tipo de ubicación de la reunión. Los valores válidos son "PHONE", "ADDRESS" y "CUSTOM". enum: - ADDRESS - CUSTOM - PHONE hs_meeting_outcome: type: string description: Una cadena que representa el resultado de la reunión. hs_meeting_start_time: type: string description: La hora de inicio de la reunión, en formato ISO 8601. format: date-time hs_meeting_title: type: string description: El título de la reunión. Es un valor de cadena. hs_timestamp: type: string description: >- Una marca de tiempo que indica cuándo se creó el evento de reunión, en formato ISO 8601. format: date-time hubspot_owner_id: type: string description: >- El identificador único del propietario de HubSpot asociado a la reunión. ExternalCalendarMeetingEventResponseProperties: required: - hs_engagement_source - hs_engagement_source_id - hs_meeting_end_time - hs_meeting_outcome - hs_meeting_start_time - hs_meeting_title - hs_timestamp type: object properties: hs_activity_type: type: string description: El tipo de actividad asociada a la reunión. hs_attachment_ids: type: array description: >- Una lista de identificadores únicos para los archivos adjuntos asociados a la reunión. items: type: string hs_attendee_owner_ids: type: array description: >- Un conjunto de identificadores únicos para los propietarios de los asistentes. items: type: string hs_engagement_source: type: string description: >- El origen de la interacción. Los valores válidos incluyen una amplia gama de orígenes, como "UNKNOWN", "IMPORT", "API", "FORM" y muchos otros. enum: - ACADEMY - ACCEPTANCE_TEST - ACTIVITY_AUTO_ASSOCIATE - ACTIVITY_LOG_REVERT - ADS - AI_GROUP - ANALYTICS - API - APPROVALS - ASSISTS - ASSOCIATIONS - AUTO_ASSOCIATE_BY_DOMAIN - AUTOMATION_JOURNEY - AUTOMATION_PLATFORM - AVATARS_SERVICE - BATCH_UPDATE - BCC_TO_CRM - BEHAVIORAL_EVENTS - BET_ASSIGNMENT - BET_CRM_CONNECTOR - BIDEN - BILLING - BOT - BREEZE_AGENT - CALCULATED - CENTRAL_EXCHANGE_RATES - CHATSPOT - CLONE_OBJECTS - COMMUNICATOR - COMPANIES - COMPANY_FAMILIES - COMPANY_INSIGHTS - CONNECTED_ACCOUNT - CONTACTS - CONTACTS_WEB - CONTENT_MEMBERSHIP - CONVERSATIONAL_ENRICHMENT - CONVERSATIONS - CRM_PROCESSES_PLATFORM - CRM_UI - CRM_UI_BULK_ACTION - CUSTOMER_AGENT - CUSTOMER_PORTAL - DATA_ENRICHMENT - DATA_QUALITY - DATASET - DEALS - DEFAULT - DELETE_OBJECTS - DI_WRITE_TO_CRM - EMAIL - EMAIL_INBOX_IMPORT - EMAIL_INTEGRATION - ENGAGEMENTS - EXTENSION - FILE_MANAGER - FLYWHEEL_PRODUCT_DATA_SYNC - FORECASTING - FORM - FORWARD_TO_CRM - GMAIL_INTEGRATION - GOALS - HEISENBERG - HELP_DESK - HELP_DESK_AI - IMPORT - INTEGRATION - INTEGRATIONS_PLATFORM - INTEGRATIONS_SYNC - INTENT - INTERNAL_PROCESSING - LEADIN - LEGAL_BASIS_REMEDIATION - MARKET_SOURCING - MARKETPLACE - MARKETS - MEETINGS - MERGE_COMPANIES - MERGE_CONTACTS - MERGE_OBJECTS - MERGE_REVERT_OBJECTS - MICROAPPS - MIGRATION - MOBILE_ANDROID - MOBILE_IOS - PAYMENTS - PIPELINE_SETTINGS - PLAYBOOKS - PORTAL_OBJECT_SYNC - PORTAL_USER_ASSOCIATOR - PRESENTATIONS - PRIMARY_AUTOMATION - PROPERTY_DEFAULT_VALUE - PROPERTY_RESTORE - PROPERTY_SETTINGS - PROSPECTING_AGENT - QUOTAS - QUOTES - RECYCLING_BIN - RESTORE_OBJECTS - REVENUE_PLATFORM - SALES - SALES_MESSAGES - SALESFORCE - SEQUENCES - SETTINGS - SIDEKICK - SIGNALS - SLACK_INTEGRATION - SMART_DATA_CAPTURE - SOCIAL - SUCCESS - TALLY - TASK - UNKNOWN - WAL_INCREMENTAL - WORK_UI - WORKFLOW_CONTACT_DELETE_ACTION - WORKFLOWS hs_engagement_source_id: type: string description: El identificador único de la fuente de la interacción. hs_include_description_in_reminder: type: string description: >- Indica si la descripción de la reunión debe incluirse en los recordatorios. hs_internal_meeting_notes: type: string description: Notas internas relacionadas con la reunión. hs_meeting_body: type: string description: El cuerpo o la descripción de la reunión. hs_meeting_end_time: type: string description: La hora de finalización de la reunión, en formato ISO 8601. format: date-time hs_meeting_external_url: type: string description: La URL externa asociada a la reunión. hs_meeting_location: type: string description: El lugar donde se celebra la reunión. hs_meeting_location_type: type: string description: >- El tipo de ubicación de la reunión. Los valores válidos son "PHONE", "ADDRESS" y "CUSTOM". enum: - ADDRESS - CUSTOM - PHONE hs_meeting_outcome: type: string description: El resultado de la reunión. hs_meeting_start_time: type: string description: La hora de inicio de la reunión, en formato ISO 8601. format: date-time hs_meeting_title: type: string description: El título de la reunión. hs_timestamp: type: string description: >- Una marca de tiempo que indica cuándo se registró el evento de reunión, en formato ISO 8601. format: date-time hs_unique_id: type: string description: Un identificador único del evento de reunión. hubspot_owner_id: type: string description: >- El identificador único del propietario de HubSpot asociado a la reunión. 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 PublicObjectId: required: - id type: object properties: id: type: string description: >- El identificador único para el objeto público. Es una cadena que sirve como referencia al objeto dentro de la API. description: Contains the Id of a Public Object AssociationSpec: required: - associationCategory - associationTypeId type: object properties: associationCategory: type: string description: >- Una cadena que indica la categoría de la asociación. Los valores válidos son "HUBSPOT_DEFINED", "USER_DEFINED", "INTEGRATOR_DEFINED" y "WORK". enum: - HUBSPOT_DEFINED - INTEGRATOR_DEFINED - USER_DEFINED - WORK associationTypeId: type: integer description: >- Un número entero que representa el identificador único para el tipo de asociación. format: int32 description: >- Defines the type, direction, and details of the relationship between two CRM objects. ExternalReminder: required: - numberOfTimeUnits - timeUnit type: object properties: numberOfTimeUnits: type: integer description: >- El número de unidades de tiempo antes de la reunión en que se debe enviar el recordatorio, que es un valor entero. format: int32 timeUnit: type: string description: >- La unidad de tiempo para el recordatorio. Los valores válidos son "WEEKS", "DAYS", "HOURS" y "MINUTES". enum: - DAYS - HOURS - MINUTES - WEEKS 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. 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: '' ````