Fire an Entry Event

There are two ways to send events to Journey Builder:

  • Using a Fire Event Activity in Automation Studio
  • By POSTing an event to the Journey Builder API

To send events using the API:

  1. Define the event and its properties.
    • If you define the event in the web interface, note the event definition key.
    • If you define the event by using the API, use the POST /eventDefinition resource.
  2. Use a valid OAuth access token to authorize requests to REST API.
  3. Using the POST /events resource, POST the required fields and event properties to the API.

When an event is posted to the API, the data schema of the associated data extension validates that all fields from the API call exist in the data extension. The data extension associated with an event is defined in the DataExtensionID field in the EventDefinition table.

  • If a field is missing, a validation exception is thrown.
  • If the request is successful, an eventInstanceId is returned. This ID is a unique identifier for this specific request.