Enhanced Creations and Associations of Lists with Marketing Events via API

hseligson — Fri, 11 Oct 2024 15:06:09 GMT

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.

Re: Enhanced Creations and Associations of Lists with Marketing Events via API

Jnix284 — Fri, 11 Oct 2024 15:21:16 GMT

@MrJustinGivens 👏👏👏

Re: Enhanced Creations and Associations of Lists with Marketing Events via API

MrJustinGivens — Fri, 11 Oct 2024 15:34:25 GMT

Uh @hseligson

@Jnix284 you're faster to reply than me.

Re: Enhanced Creations and Associations of Lists with Marketing Events via API

hseligson — Fri, 11 Oct 2024 15:44:10 GMT

@MrJustinGivens Sorry for not mentioning it yesterday!

Re: Enhanced Creations and Associations of Lists with Marketing Events via API

Jnix284 — Fri, 11 Oct 2024 16:55:53 GMT

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

topic Re: Enhanced Creations and Associations of Lists with Marketing Events via API in Developer Announcements

Enhanced Creations and Associations of Lists with Marketing Events via API

What's changing?

When is it happening?

Re: Enhanced Creations and Associations of Lists with Marketing Events via API

Re: Enhanced Creations and Associations of Lists with Marketing Events via API

Re: Enhanced Creations and Associations of Lists with Marketing Events via API

Re: Enhanced Creations and Associations of Lists with Marketing Events via API