Skip to content
HubSpot Developer Changelog

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 Associations:

  • 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.
DELETE /marketing/v3/marketing-events/associations/{marketingEventId}/lists/{listId}
  • Delete list association by External Event IDs: Remove the association between an external marketing event and a contact list.
DELETE /marketing/v3/marketing-events/associations/{externalAccountId}/{externalEventId}/lists/{listId}

When is it happening?

Developers can now use these new endpoints to simplify their event and contact list management processes.

Questions or comments? Join us in the developer forums for peer-to-peer discussions.