Get Started with the Journey Builder API

To integrate with Journey Builder programmatically, you must first obtain an authentication token.

  1. To get a client ID and secret, create an installed package with an API Integration component.
  2. Using the above credentials, get an OAuth access token for authenticating your API calls.
  3. Use the access token in the header to authenticate each subsequent call.

  1. Create a sendable data extension.

  2. Create an event definition. The event definition determines entry settings for the journey, controlling who gets in and when. Use the sendable data extension created in step 1 as the entry source. If using a custom application for Journey Builder functionality, you can also define an entry event via the API using the POST /eventDefinitions resource.

  3. Build the journey. Use the Journey Specification to build out the JSON of your journey.

    • Define the activities. Activities determine the pace and content of contact messaging and data updates as the journey executes. Marketers create a chain of activities by dragging and dropping activities onto the Canvas.
    • Define a goal (optional). A goal measures the journey's effectiveness.

  4. Publish the journey. Once a journey is active, Marketing Cloud Engagement continually evaluates Contacts using the entry event criteria to determine if a journey should be invoked.

  5. Fire an entry event. A journey begins when the event it is configured to detect occurs. Use the event definition key created for the event definition in step 2.