Using the events API in outbound marketing
Note
Dynamics 365 Marketing and Dynamics 365 Customer Insights are now Customer Insights - Journeys and Customer Insights - Data. For more information, see Dynamics 365 Customer Insights FAQs
New Customer Insights - Journeys customers receive real-time journeys features only. For more information, see Default real-time journeys installation.
Important
This article only applies to outbound marketing, which will be removed from the product on June 30, 2025. To avoid interruptions, transition to real-time journeys before this date. More information: Transition overview
The events API is a programmatic method to access data of events, sessions, session tracks, passes, speakers, and sponsorships. Additionally, it allows you to register for events and sessions.
Schema
The API access is over HTTPS protocol and is accessed from the API endpoint that you receive while creating a web application token. All data is sent and received as JSON.
Blank fields are included as null
instead of being omitted.
Endpoint
Every customer has their own endpoint URL. The Event API endpoint URL consists of two parts:
- The endpoint domain
- The subdirectory
You will get the root endpoint after creating a web application token. You can find more information on how to create a web application token here: Register web application.
Example for root endpoint
https://b7c1ad1ab7fa4a7482b16315d94a26af.svc.dynamics.com
The subdirectory always starts with EvtMgmt/api
followed by the API version (which can be retrieved from the API documentation available here: Event management API reference docs.
Example for subdirectory
EvtMgmt/api/v2.0/
Example for full endpoint URL
https://b7c1ad1ab7fa4a7482b16315d94a26af.svc.dynamics.com/EvtMgmt/api/v2.0/
Authentication
To use the events API, you need to provide a web application token
as a URL parameter in each request. The web application token is used to control API requests that are associated with your organization. See Register web application for more information on how to create and retrieve a web application.
The web application token
can be added to the request by adding a URL parameter called emApplicationtoken
.
Example
https://b7c1ad1ab7fa4a7482b16315d94a26af.svc.dynamics.com/EvtMgmt/api/v2.0/events/published?emApplicationtoken=B7vdzdhCiLt9c5iT….
Additionally, the origin from where the request is sent must be equal to the origin specified when creating the web application token.
If you do not provide a web application token or the Origin Header, the events API will return HTTP 400 Bad Request
.
If the web application token is invalid, the events API will return HTTP 401 Unauthorized
.
Register your web application
To use the events API, you need to provide a web application token in each request. The web application token is used to control API requests that are associated with your organization. More information: Register your web application