Set Identifier

The Set Identifier Action sets the Journey identifier. Journeys are identified in three different ways.

  • A unique sessionId that is automatically created for each Journey. This cannot be modified.
  • The variable, which is the user's unique phone number.
  • A custom identifier, which can be any Text as specified by this Action.
  • An identifier is used to uniquely identify a Journey from either an App API or an Event, specifically when the Start Journey data operation is used to lookup and use an existing session. The Set Identifier Action can only be used for the third type of identifier above, a custom identifier.

Use Cases

  • To send a Session Event to a running App
  • To send a message to a specific user
  • To update the status of a request from an external system
  • To use a custom ID from your system of record. For instance, a user could be identified based on their Salesforce Contact ID, or their Zendesk ID



Expects type Text.

The value that will be used to uniquely identify a Journey.

Existing Session Behavior

This property has two options: Fail and Replace. When the Set Identifier Action is run, and there is an existing Journey with the same identifier that was just specified, these options decide what happens:

If Fail is selected, then this Action does nothing. The existing Journey is not modified, and the Journey that called Set Identifier will not claim the identifier.

If Replace is selected, then the Journey that called the Set Identifier takes over the existing Journey's identifier, removing the identifier from the existing Journey, if any.