Edit

Using the events API in outbound marketing

  • Article

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.

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