Upcoming: Changes to the Marketing Events API
We're releasing some new features for marketing events. These new features include the ability to create contacts from the events, as well as tracking registration and detailed attendance for the events.
As part of these updates, we're making changes to the Marketing Events API to support these new features.
3 new endpoints are being released:
Changes the state of a specified attendee. The state can be:
cancel. If the state is
attend, you can optionally include
leftAtvalues to record how long they attended the event.
Works like the previous endpoint, but can use an email address instead of a contact record ID to create a new contact in HubSpot.
This endpoint is used after the event is finished, and all attendance updates have been made. Calling this endpoint triggers the calculation of the attendance duration for all attendees, which updates the timeline entries for the attendees.
What's being removed?
With the release of the new endpoints, 2 endpoints are being sunset:
This is replaced by the new
This is being replaced by the new
Aside from the new URLs, the main difference between the old endpoints and the new ones is the support of the optional
leftAt fields. Otherwise the data will be the same as you used with the old endpoints.
Additionally, you will need to make a request to the new
/complete endpoint to make sure that the attendance duration is displayed in the timeline of the related contact records in HubSpot.
When is this happening?
The new endpoints and functionality are available today, and can be used immediately. Please see the Marketing Events API documentation for details on using the new endpoints.
The 2 sunset endpoints will be removed on April 30th, 2023.
Please let us know if you have any questions by joining the discussion in our community.