> ## 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 el sistema de HubSpot. Este punto de terminación te permite programar reuniones al proporcionar los detalles necesarios, como el título de la reunión, las horas de inicio y finalización, y la información de usuario asociada. Es esencial para organizar reuniones y gestionar agendas dentro de la plataforma de HubSpot. 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/2027-03-beta/scheduler-meetings-v2027-03-beta.json POST /scheduler/2027-03-beta/meetings/calendar openapi: 3.0.1 info: title: Scheduler Meetings description: Meetings Service For HubSpot Sales version: 2027-03-beta 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/2027-03-beta/meetings/calendar: post: tags: - Advanced summary: Crear reunión description: >- Crea un nuevo evento de reunión en el sistema de HubSpot. Este punto de terminación te permite programar reuniones al proporcionar los detalles necesarios, como el título de la reunión, las horas de inicio y finalización, y la información de usuario asociada. Es esencial para organizar reuniones y gestionar agendas dentro de la plataforma de HubSpot. operationId: >- post-/scheduler/2027-03-beta/meetings/calendar_/scheduler/2026-09-beta/meetings/calendar parameters: - name: organizerUserId in: query description: '' 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: >- Una conjunto de objetos de asociación que vinculan el evento de reunión con otros objetos de HubSpot, como contactos o negocios. 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á programada la 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, en formato ISO 8601. format: date-time id: type: string description: >- El identificador único del evento de reunión, representado como una cadena. lastUpdatedAt: type: string description: >- La fecha y hora en que el evento de reunión 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 asociación que definen los tipos de asociaciones que se crearán. Cada elemento del conjunto es una referencia a un esquema AssociationSpec. items: $ref: '#/components/schemas/AssociationSpec' ExternalEmailReminderSchedule: required: - reminders - shouldIncludeInviteDescription type: object properties: reminders: type: array description: >- Una conjunto de objetos de recordatorio, cada uno de los cuales especifica el momento para enviar un recordatorio antes de la reunión. Cada recordatorio incluye el número de unidades de tiempo y el tipo de unidad de tiempo (por ejemplo, semanas, días, horas, minutos). items: $ref: '#/components/schemas/ExternalReminder' shouldIncludeInviteDescription: type: boolean description: >- Un booleano que indica si la descripción de la invitación a la reunión debe incluirse en los recordatorios 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: >- Una lista de ID de archivos adjuntos asociados a la reunión. Cada ID es una cadena. items: type: string hs_attendee_owner_ids: type: array description: >- Una lista de ID de propietarios de los asistentes a la reunión. Cada ID es una cadena. items: type: string hs_internal_meeting_notes: type: string description: Notas internas para la reunión. 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 de fecha y hora 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: El resultado de la reunión. Es un valor de cadena. hs_meeting_start_time: type: string description: >- La hora de inicio de la reunión, en formato de fecha y hora 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: >- La marca de tiempo de la creación del evento de reunión, en formato de fecha y hora ISO 8601. format: date-time hubspot_owner_id: type: string description: >- El identificador único del propietario de HubSpot asociado a la reunión. Es un valor de cadena. 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 al evento de reunión. hs_attachment_ids: type: array description: >- Una lista de identificadores únicos para los archivos adjuntos asociados al evento de reunión. items: type: string hs_attendee_owner_ids: type: array description: >- Una lista de identificadores únicos de los propietarios de los asistentes asociados al evento de reunión. items: type: string hs_engagement_source: type: string description: >- La fuente de la interacción para el evento de reunión. Los valores válidos incluyen una amplia gama de fuentes, como "UNKNOWN", "IMPORT", "API", "FORM" y muchas otras. 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 el evento de reunión. hs_meeting_body: type: string description: El cuerpo o la descripción del evento de la reunión. hs_meeting_end_time: type: string description: La hora de finalización del evento de reunión, en formato ISO 8601. format: date-time hs_meeting_external_url: type: string description: La URL externa asociada al evento de 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 del evento de reunión. Los valores válidos son "PHONE", "ADDRESS" y "CUSTOM". enum: - ADDRESS - CUSTOM - PHONE hs_meeting_outcome: type: string description: El resultado del evento de reunión. hs_meeting_start_time: type: string description: La hora de inicio del evento de reunión, en formato ISO 8601. format: date-time hs_meeting_title: type: string description: El título del evento de reunión. hs_timestamp: type: string description: >- Una marca de tiempo que indica cuándo se creó o actualizó por última vez 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 al evento de reunión. Error: required: - category - correlationId - message type: object properties: category: type: string description: La categoría del error context: type: object additionalProperties: type: array items: type: string description: Contexto de la condición de error example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identificador único para la solicitud. Incluye este valor con cualquier informe de error o ticket de asistencia. format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: información adicional acerca del error items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Un mapa de nombres de enlaces a las URI asociadas que contienen documentación sobre el error o los pasos recomendados para solucionarlo message: type: string description: >- Un mensaje legible en el que se describa el error y los pasos para solucionarlo, si procede example: An error occurred subCategory: type: string description: >- Una categoría específica que contiene detalles más concretos acerca del error 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, representado como una cadena. description: Contains the Id of a Public Object AssociationSpec: required: - associationCategory - associationTypeId type: object properties: associationCategory: type: string description: >- Una cadena que representa la categoría de la asociación. Los valores válidos incluyen "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. Es un valor entero. format: int32 timeUnit: type: string description: >- La unidad de tiempo utilizada para el recordatorio. Los valores válidos incluyen "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 de la condición de error 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 en el que se describa el error y los pasos para solucionarlo, si procede 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: '' ````