Enhanced Creations and Associations of Lists with Marketing Events via API
HubSpot is excited to introduce new API endpoints to associate contact lists with marketing events seamlessly. This functionality is particularly valuable for app developers who create marketing solutions on HubSpot’s marketplace, facilitating better event management and contact segmentation.
What's changing?
Event-List Associations: The ability to programmatically create, read, and delete associations between marketing events and contact lists through new API endpoints.
Improved Event Management: This new functionality makes it easier to manage participants by segmenting them based on contact list association, providing developers with tools for better event management.
Efficiency: Developers no longer need to manage event participants manually, improving operational efficiency and allowing for more targeted post-event marketing efforts.
See below for the new endpoints for List and Event Association:
Create list association by Marketing Event ID: Associate a specific marketing event with a contact list using the event's unique ID.
PUT /marketing/v3/marketing-events/associations/{marketingEventId}/lists/{listId}
Create list association by External Event IDs: Use external account and event IDs to create associations between marketing events and contact lists.
PUT /marketing/v3/marketing-events/associations/{externalAccountId}/{externalEventId}/lists/{listId}
Read associated lists by Marketing Event ID: Retrieve all contact lists associated with a marketing event.
GET /marketing/v3/marketing-events/associations/{marketingEventId}/lists
Read associated lists by External Event IDs: Fetch lists associated with external event IDs.
GET /marketing/v3/marketing-events/associations/{externalAccountId}/{externalEventId}/lists
Delete list association by Marketing Event ID: Remove the association between a marketing event and a contact list.