{scope}
A medida que asocies listas a tus eventos de marketing, aparecerán en la página de detalles del evento de marketing en tu cuenta de HubSpot:
* En tu cuenta de HubSpot, navega a **CRM** > **Contactos**.
* En la parte superior izquierda, haz clic en **Contactos** y en el menú desplegable, selecciona **Eventos de marketing**.
* Haz clic en el **nombre** de un evento de marketing.
* En la pestaña *Rendimiento*, haz clic en **Listas** para ampliar la sección y, a continuación, haz clic en la pestaña **Listas agregadas a través de asociaciones**.
### Crear una asociación entre una lista y un ID de evento de marketing
Para crear una nueva asociación entre un evento de marketing y una lista existente, haz una solicitud `PUT` a `/marketing/v3/marketing-events/associations/{marketingEventId}/lists/{listId}`.
Si tiene éxito, recibirás una respuesta `204 No content`.
### Crear una asociación entre una lista y un evento externo e ID de cuenta
Para crear una nueva asociación entre un evento de marketing y una lista existente utilizando el ID de cuenta externa y el ID de evento externo, haz una solicitud `PUT` a `/marketing/v3/marketing-events/associations/{externalAccountId}/{externalEventId}/lists/{listId}`.
Si tiene éxito, recibirás una respuesta `204 No content`.
### Obtener las listas asociadas a un evento de marketing utilizando el ID del evento
Para obtener todas las listas asociadas a un evento de marketing, haz una solicitud `GET` a `/marketing/v3/marketing-events/associations/{marketingEventId}/lists`.
La respuesta tendrá el siguiente formato:
```json theme={null}
{
"total": 1,
"results": [
{
"listId": "string",
"listVersion": 0,
"createdAt": "2024-05-10T08:58:35.769Z",
"updatedAt": "2024-05-10T08:58:35.769Z",
"filtersUpdatedAt": "2024-05-10T08:58:35.769Z",
"processingStatus": "string",
"createdById": "string",
"updatedById": "string",
"processingType": "string",
"objectTypeId": "string",
"name": "string",
"size": 0
}
]
}
```
### Obtener las listas asociadas a un evento de marketing utilizando el ID y las cuentas externas
También puedes obtener listas asociadas a un evento de marketing utilizando el ID de una cuenta externa y el ID de un evento externo. Para ello, haz una solicitud `GET` a `/marketing/v3/marketing-events/associations/{externalAccountId}/{externalEventId}/lists`.
### Eliminar la asociación de una lista mediante un ID de evento de marketing
Para eliminar la asociación de una lista con un evento de marketing utilizando el ID del evento de marketing, haz una solicitud `DELETE` a `/marketing/v3/marketing-events/associations/{marketingEventId}/lists/{listId}`.
Si tiene éxito, recibirás una respuesta `204 No content`.
### Borrar la asociación de una lista mediante un evento externo y el ID de una cuenta
Para eliminar la asociación de una lista y un evento de marketing utilizando el ID de una cuenta externa y el ID de un evento externo, haz una solicitud `DELETE` a `/marketing/v3/marketing-events/associations/{externalAccountId}/{externalEventId}/lists/{listId}`.
Si tiene éxito, recibirás una respuesta `204 No content`.
## Configurar los valores de la aplicación
Se requiere cierta configuración para permitir que los eventos de marketing se sincronicen correctamente con HubSpot.
Si envías a HubSpot un cambio de estado del asistente a un evento (por ejemplo, un registro en el evento o un evento cancelado), HubSpot primero comprobará si hay un evento de marketing con el ID del evento especificado. Si no es así, HubSpot llamará al punto de conexión configurado de tu aplicación para obtener los detalles del evento de marketing, luego creará el evento en HubSpot y luego, publicará el cambio de estado del asistente.
Esto se proporciona por conveniencia; sin embargo, se recomienda que crees los eventos de marketing mediante los métodos CRUD que se detallan en [este documento](/docs/api-reference/marketing-marketing-events-v3/guide) y no confíes en esta funcionalidad para crear tus eventos de marketing en HubSpot.
### Paso 1: Crea una API en tu aplicación
Para que esta funcionalidad sea posible, HubSpot requiere que cada aplicación que use eventos de marketing defina una API para obtener información sobre un evento específico.
Requisitos:
* Acepta:
* `externalAccountId`: un parámetro de consulta que especifica el accountId del cliente en la aplicación externa.
* `appId`: un parámetro de consulta que especifica el ID de la aplicación de HubSpot que solicita los detalles del evento. Este será el ID de tu aplicación.
* `externalEventId`: un parámetro de ruta en la URL de la solicitud que especifica el ID del evento en la aplicación externa sobre la que HubSpot requiere detalles.
* Devuelve:
* Un objeto JSON que proporciona los detalles del evento de marketing, y que incluye los campos de esta tabla:
\| Nombre del campo | Requerido | Tipo | Descripción del campo |
\| ------------------ | --------- | --------------------- | ------------------------------------------------------------------------------------- | --- |
\| `eventName` | verdadero | cadena | El nombre del evento de marketing |
\| `eventOrganizer` | verdadero | cadena | El nombre del organizador del evento de marketing. |
\| `eventType` | falso | cadena | Describe qué tipo de evento es este. Por ejemplo, `WEBINAR`, `CONFERENCE`, `WORKSHOP` | . |
\| `startDateTime` | falso | cadena (fecha y hora) | La fecha y la hora de inicio del evento de marketing. |
\| `endDateTime` | falso | cadena (fecha y hora) | La fecha y la hora de finalización del evento de marketing. |
\| `eventDescription` | falso | cadena (fecha y hora) | La descripción del evento de marketing. |
\| `eventUrl` | falso | cadena (fecha y hora) | Una URL en la aplicación del evento externo donde se realiza el evento de marketing. |
\| `eventCancelled` | falso | boolenano | Indica si el evento de marketing se canceló. El valor predeterminado es `false` |
HubSpot también enviará un encabezado `X-HubSpot-Signature-v3` que puedes usar para verificar que la solicitud proviene de HubSpot. Consulta información sobre las [firmas de solicitud](/docs/apps/legacy-apps/authentication/validating-requests) para obtener detalles adicionales sobre la firma y cómo validarla.
### Paso 2: Da a HubSpot la ruta URL a la API
Ahora que has creado la API en tu aplicación que devolverá un objeto con los detalles de un evento de marketing específico, deberás proporcionar a HubSpot la ruta de la URL a la API haciendo una solicitud `POST` a `/marketing/v3/marketing-events/{appId}/settings`. Esto permitirá a HubSpot determinar cómo realizar solicitudes a tu aplicación para obtener los detalles de un evento de marketing.
En el cuerpo de tu solicitud `POST`, especifica la URL utilizando el campo `eventDetailsURL`. El `eventDetailsURL` debe cumplir con los siguientes requisitos:
* Contener una secuencia de caracteres `%s`, que HubSpot utilizará para hacer la substitución en el ID del evento (`externalEventId`) como parámetro de ruta.
* Debe ser la ruta completa al recurso API, incluido el prefijo `https://` y el nombre de dominio (por ejemplo, `my.event.app`).
Por ejemplo, si configuras un `eventDetailsURL` de `https://my.event.app/events/%s` y necesitas hacer una solicitud para obtener detalles de un evento con el ID `1234-event-XYZ`, de la aplicación HubSpot con el ID `app-101` y la cuenta con el ID `ABC-account-789`, HubSpot hará una solicitud `GET` a:
`https://my.event.app/events/1234-event-XYZ?appId=app-101&externalAccountId=ABC-account-789`