Developer Announcements

hseligson
HubSpot Employee
HubSpot Employee

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.
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 concerns? Please join the forum below for a peer-to-peer discussion.

4 Replies 4
Jnix284
Hall of Famer

Enhanced Creations and Associations of Lists with Marketing Events via API

@MrJustinGivens 👏👏👏


If my reply answered your question please mark it as a solution to make it easier for others to find.


Jennifer Nixon
MrJustinGivens
Top Contributor | Platinum Partner
Top Contributor | Platinum Partner

Enhanced Creations and Associations of Lists with Marketing Events via API

Uh @hseligson 

 

@Jnix284 you're faster to reply than me. 









Jnix284
Hall of Famer

Enhanced Creations and Associations of Lists with Marketing Events via API

and there I thought you would've been in the alpha @MrJustinGivens 🤦🏼‍♀️


If my reply answered your question please mark it as a solution to make it easier for others to find.


Jennifer Nixon
0 Upvotes
hseligson
HubSpot Employee
HubSpot Employee

Enhanced Creations and Associations of Lists with Marketing Events via API

@MrJustinGivens Sorry for not mentioning it yesterday!