> ## 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 event by external ID > Devuelve los detalles de un evento de marketing con el externalAccountId, externalEventId especificado, si existe. Solo se recuperan eventos de marketing creados por la misma aplicación que hace la solicitud. 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/legacy/v3/marketing-marketing-events-v3.json GET /marketing/v3/marketing-events/events/{externalEventId} openapi: 3.0.1 info: title: Marketing Marketing Events description: Basepom for all HubSpot Projects version: v3 x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE x-hubspot-related-documentation: - name: Marketing Events Guide url: >- https://developers.hubspot.com/docs/guides/api/marketing/marketing-events servers: - url: https://api.hubapi.com security: [] tags: - name: Basic - name: Batch - name: Event Attendees - name: Event Status - name: Identifiers - name: List Associations - name: Participant State - name: Settings - name: Subscriber State Changes paths: /marketing/v3/marketing-events/events/{externalEventId}: get: tags: - Basic summary: Obtener eventos de marketing por ID externos description: >- Devuelve los detalles de un evento de marketing con el externalAccountId, externalEventId especificado, si existe. Solo se recuperan eventos de marketing creados por la misma aplicación que hace la solicitud. operationId: get-/marketing/v3/marketing-events/events/{externalEventId}_getDetails parameters: - name: externalEventId in: path description: El ID del evento de marketing en la aplicación de eventos externos required: true style: simple explode: false schema: type: string - name: externalAccountId in: query description: >- El accountId que está asociado con este evento de marketing en la aplicación de eventos externos required: true style: form explode: true schema: type: string responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/MarketingEventPublicReadResponse' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - crm.objects.marketing_events.read components: schemas: MarketingEventPublicReadResponse: required: - attendees - cancellations - createdAt - customProperties - eventName - eventOrganizer - externalEventId - id - noShows - registrants - updatedAt type: object properties: attendees: type: integer description: >- El número de contactos de HubSpot que asistieron a este evento de marketing. format: int32 cancellations: type: integer description: >- El número de contactos de HubSpot que se registraron para este evento de marketing, pero luego cancelaron su registro. format: int32 createdAt: type: string description: La fecha y hora de creación del evento de marketing. format: date-time customProperties: type: array description: > Una lista de PropertyValues. Pueden ser cualquier tipo de nombres y valores de propiedad que desees. Sin embargo, deben existir previamente en la definición del objeto MarketingEvent de la cuenta de HubSpot. Si no es así, serán filtrados y no se establecerán. Para hacer esto, deberás crear un nuevo PropertyGroup en el objeto MarketingEvent de la cuenta de HubSpot para tu aplicación específica y crear la Propiedad Personalizada a la que deseas hacer seguimiento en esa cuenta de HubSpot. No crees ninguna propiedad predeterminada nueva en el objeto MarketingEvent, ya que esa propiedad se aplicará a todas las cuentas de HubSpot. items: $ref: '#/components/schemas/PropertyValue' endDateTime: type: string description: La fecha y la hora de finalización del evento de marketing. format: date-time eventCancelled: type: boolean description: Indica si el evento de marketing se canceló. eventCompleted: type: boolean description: Indica si el evento de marketing se ha completado. eventDescription: type: string description: La descripción del evento de marketing. eventName: type: string description: El nombre del evento de marketing. eventOrganizer: type: string description: El nombre del organizador del evento de marketing. eventType: type: string description: El tipo del evento de marketing. eventUrl: type: string description: >- Una URL en la aplicación de eventos externos donde se puede gestionar el evento de marketing. externalEventId: type: string description: El id del evento de marketing en la aplicación de eventos externos. id: type: string description: El ID del objeto del CRM del evento de marketing. noShows: type: integer description: >- El número de contactos de HubSpot que se registraron para este evento de marketing, pero no asistieron. Este campo solo tiene un valor cuando el evento ha terminado. format: int32 objectId: type: string description: El ID del objeto del CRM del evento de marketing. registrants: type: integer description: >- El número de contactos de HubSpot que se registraron para este evento de marketing. format: int32 startDateTime: type: string description: La fecha y la hora de inicio del evento de marketing. format: date-time updatedAt: type: string description: La fecha y hora de actualización del evento de marketing. format: date-time PropertyValue: required: - dataSensitivity - isEncrypted - isLargeValue - name - persistenceTimestamp - requestId - selectedByUser - selectedByUserTimestamp - source - sourceId - sourceLabel - sourceMetadata - sourceUpstreamDeployable - sourceVid - timestamp - unit - updatedByUserId - useTimestampAsPersistenceTimestamp - value type: object properties: dataSensitivity: type: string description: Nivel de sensibilidad de los datos enum: - high - none - standard isEncrypted: type: boolean description: Indica si la propiedad está encriptada isLargeValue: type: boolean description: >- Indica si el valor de la propiedad se almacena como un valor grande en el almacén name: type: string description: Nombre de la propiedad personalizada persistenceTimestamp: type: integer description: >- La marca de tiempo que indica cuándo el valor que se está escribiendo persiste en el almacenamiento format: int64 requestId: type: string description: El ID de la solicitud selectedByUser: type: boolean description: Indica si la propiedad está seleccionada selectedByUserTimestamp: type: integer description: Fecha y hora en que el usuario seleccionó la propiedad format: int64 source: type: string description: Origen de la propiedad 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 sourceId: type: string description: ID del origen de la propiedad sourceLabel: type: string description: Etiqueta del origen de la propiedad sourceMetadata: type: string description: Metadatos de origen codificados como una cadena base64 sourceUpstreamDeployable: type: string description: Indica qué servicio ascendente realizó el cambio de propiedad sourceVid: type: array description: El identificador único asociado a la fuente. items: type: integer format: int64 timestamp: type: integer description: Marca de tiempo de la solicitud format: int64 unit: type: string description: La unidad updatedByUserId: type: integer description: El ID del usuario que actualizó la propiedad por última vez format: int32 useTimestampAsPersistenceTimestamp: type: boolean description: >- Indica si la marca de tiempo de persistencia es la misma que la marca de tiempo de la versión de almacenamiento value: type: string description: Valor de propiedad personalizada description: >- Representa una sola propiedad personalizada de un evento de marketing, que almacena su nombre, valor, metadatos (como origen, marca de tiempo y sensibilidad) e información de auditoría relacionada para el seguimiento de cambios. 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 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 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 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.marketing_events.read: '' crm.objects.marketing_events.write: '' developers-read: '' developers-write: '' ````