Skip to main content

Hello everyone, 

 

I'm currently developing a solution to programmatically create and manage journeys using the Journey Specification for [

https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/getting-started-spec.html

]. 

 

During development, I've run into a significant challenge: the official documentation for the Journey Specification appears to be incomplete. Many key attributes that exist in a journey's JSON payload, particularly within the activities array, are not defined or described in the available documentation. 

 

Specific Problems: 

 

  1. Missing Attributes: Numerous required and optional attributes are simply not mentioned. We are currently forced to reverse-engineer their purpose by inspecting the payload of existing journeys.
  2. Unclear Definitions: For the attributes that are documented, the specifications often lack crucial details such as data types, possible enum values, value ranges, or clear use-case descriptions.

 

This lack of comprehensive documentation makes our development process heavily reliant on trial and error, which is inefficient and raises concerns about the long-term stability and compatibility of our journeys with future platform updates. 

 

My Questions for the Community: 

 

  • Is there a more complete or detailed official documentation/API reference for the Journey Specification that I might have missed?
  • Has anyone in the community compiled any unofficial resources, notes, or guides that cover the full specification?
  • Specifically, could anyone provide insight into the structure and purpose of attributes like [e.g., a specific field within metaData or configurationArguments that you are struggling with]?

 

Any pointers to more comprehensive documentation would be greatly appreciated. 

 

Thank you! 

1 answer
0/9000