Los endpoints de preferencias de suscripción te permiten administrar los detalles de las suscripciones para contactos en un portal de HubSpot
Última modificación: 22 de agosto de 2025
Los tipos de suscripción representan la base legal para comunicarte con tus contactos a través de correo electrónico. Los contactos pueden gestionar sus preferencias de correo para que solo se suscriban a los correos electrónicos que desean recibir.
Nota: La API de preferencias de suscripción no admite actualmente la recuperación o actualización de la información de suscripción de WhatsApp para un contacto.
El endpoint del estado de suscripción del contacto les permite a los usuarios obtener los estados de suscripción para una dirección de correo electrónico en una cuenta.Este endpoint es ideal para cuando tienes un centro de preferencias externas o una integración y necesitas saber los estados de suscripción para cualquier dirección de correo electrónico en tu cuenta.
El endpoint para suscribir al contacto te permite suscribir a una dirección de correo electrónico a cualquier tipo de suscripción en una cuenta, pero **no te permitirá volver a suscribir contactos que cancelaron su suscripción. **
Nota: La nueva versión de la API de preferencias de suscripción v4, permite volver a suscribir a los contactos que se dieron de baja anteriormente. Obtén más información sobre la API v4 en este artículo.
Ejemplo de uso: este endpoint es ideal cuando tienes una integración o un formulario externo que necesita inscribir contactos en un tipo de suscripción.Nota: El endpoint de suscripción para contactos solo debe utilizarse para garantizar solicitudes de contactos que te han dado permiso para suscribirlos. Revisa las leyes y regulaciones aplicables antes de suscribir a un contacto.
El endpoint para cancelar la suscripción del contacto te permite cancelar la suscripción de una dirección de correo electrónico en una cuenta para cualquier tipo de suscripción.Ejemplo de uso: este endpoint es ideal para cuando tienes una integración o un formulario externo que debe excluirse voluntariamente de un tipo de suscripción.
El endpoint de información de suscripción les permite a los usuarios recuperar todos los tipos de suscripción en su cuenta.Ejemplo de uso: este endpoint es ideal para cuando tienes un centro de preferencias externas, integración o formulario y necesitas saber qué tipos de suscripción existen en tu cuenta de manera que puedas actualizar los estados de suscripción para tus contactos según corresponda.