circle-exclamation
This documentation is currently under development. Certain sections are not yet complete and will be added shortly.
search
HomeDocumentation

SFMC

hashtag
Executes the Journey Builder push update action.

post
/api/{tenantId}/webhooks/listeners/sfmc/actions/pushupdate/execute

Authorization: Requires valid tenant context via TenantConfigurationAccessControlled attribute. JWT token validation enforces authenticity of the SFMC request.

Use Cases: Triggered by Salesforce Journey Builder when a contact/customer enters this activity node during an active journey. Updates one or more wallet passes with data provided by the journey (e.g., dynamic offer text from campaign variables, additional metadata). Supports multi-pass updates identified by email, custom ID, or direct pass ID.

Behavior: Validates JWT signature against configured SFMC signing key. Parses inArguments from JWT payload to extract pass identifiers, pass type, and optional additional data. Queries the pass repository to locate matching passes. Schedules async update tasks via MediatR for each matching pass, associating them with the journey ID for tracking. Emits push update events for audit logging. Returns 404 if no passes match the provided identifiers; otherwise returns 200 with success confirmation.

Path parameters
tenantIdstringRequired
Responses
chevron-right
200

Pass updates scheduled.

No content
post
/api/{tenantId}/webhooks/listeners/sfmc/actions/pushupdate/execute
No content

hashtag
Handles publish handshakes from Journey Builder.

post
/api/{tenantId}/webhooks/listeners/sfmc/actions/pushupdate/publish

Authorization: Requires valid tenant context via TenantConfigurationAccessControlled attribute.

Use Cases: Salesforce Journey Builder initiates a publish handshake when a Journey containing this custom activity is published. This endpoint acknowledges receipt of the publish event and confirms the action is ready to execute within active journeys.

Behavior: Accepts the JWT-encoded publish notification from SFMC, logs the event for audit purposes, and returns a success response. The endpoint validates the request format but does not perform additional validation at publish time; validation occurs during journey execution.

Path parameters
tenantIdstringRequired
Responses
chevron-right
200

Publish handshake acknowledged.

No content
post
/api/{tenantId}/webhooks/listeners/sfmc/actions/pushupdate/publish
No content

Last updated