Single-Send Journeys
There are two types of Journey Builder sends:
- Multi-step journeys
- Single-send journeys
Most use cases for interacting with journeys via API involve multi-step journeys. Multi-step journeys enable you to create and manage customer journeys through a series of interactions with your brand. These journeys can include multiple channels and customized journey paths based on customer interactions or attributes. Multi-step journeys can also have different activities and versions. The Journey Builder developer documentation is based on multi-step journeys.
You can employ single-send journeys for simple, single-use journeys that marketers create in Journey Builder. However, you can interact with single-send journeys via API, if required, by modifying the journey specification. Goals, versions, and recurring scheduling are not supported for single-send journeys. Email, SMS, and push notifications are the only activities available for single-send journeys.
To set up a single-send journey via API, follow the journey specification, with these key modifications:
- In the journey object, use
Quicksend
for the definitionType parameter. - In the journey object, for the channel parameter, use one of the following values:
email
for email,push
for push notifications, orsms
for SMS messages. - In the activity object, for the type parameter in the activities list, use one of the following values:
emailv2
for email,pushnotificationactivity
for push notifications, orsmssync
for SMS messages. You can define only one activity. - In the trigger portion of the event object, use
EmailAudience
as the type parameter for email messages and SMS messages, and useContactAudience
as the type parameter for push notifications.EmailAudience
is the same as the data extension entry source in Journey Builder. - Don’t include goals, versioning, or a recurrent schedule.