Contact Us

June 2, 2024

May 13, 2026 2:49 pm

Refreshing email content in transactional journeys

Share with

Understanding the Issue

The documentation states that changes to email content are applied instantly, but this is not always the case. The issue may stem from the email itself or the transactional journey definition.

The root cause of the issue may be related to the email content or the transactional journey definition, which can cause a MessageBuildError when trying to refresh the email content.

Troubleshooting Steps

To troubleshoot the issue, try updating the email activity directly by choosing the email in Content Builder. If this does not work, try creating a new transactional journey or a new email activity to isolate the issue.

If the issue persists, it may be necessary to raise a support ticket to investigate further. Alternatively, updating the email definition via API is possible, but not recommended as a first resort.

updateMessageDefinition.js

/* Update email definition via API */
const emailDefinitionId = 'YOUR_EMAIL_DEFINITION_ID';
const updatedEmailContent = 'YOUR_UPDATED_EMAIL_CONTENT';
// Use the Marketing Cloud API to update the email definition

Best Practices

To avoid similar issues in the future, make sure to test email content thoroughly before deploying it to a transactional journey. Regularly review and update email content to ensure it remains relevant and error-free.

Troubleshooting Checklist

  • Update the email activity directly by choosing the email in Content Builder
  • Create a new transactional journey to isolate the issue
  • Create a new email activity to isolate the issue
  • Raise a support ticket to investigate further
  • Update the email definition via API (if necessary)
  • Test email content thoroughly before deploying it to a transactional journey
  • Regularly review and update email content

What is a MessageBuildError?

A MessageBuildError is an error that occurs when there is an issue with the email content or the transactional journey definition.

How do I update the email definition via API?

You can update the email definition via API using the Marketing Cloud API, but this is not recommended as a first resort.

What are the best practices for troubleshooting email content issues?

The best practices for troubleshooting email content issues include testing email content thoroughly, regularly reviewing and updating email content, and isolating the issue by creating a new transactional journey or email activity.

How do I raise a support ticket to investigate further?

You can raise a support ticket by contacting Salesforce Support directly.

What are the potential consequences of not updating email content regularly?

The potential consequences of not updating email content regularly include errors, outdated content, and a negative impact on customer engagement.

How do I prevent similar issues in the future?

You can prevent similar issues in the future by following best practices for troubleshooting email content issues, testing email content thoroughly, and regularly reviewing and updating email content.

Genetrix Technology · Salesforce Marketing Cloud Partner

Need help shipping this in production?

Genetrix builds and untangles Salesforce Marketing Cloud and Agentforce setups for teams that want it done right the first time. If anything in this post sounds familiar, talk to us before it ships.

Get in Touch with Genetrix →

Blogs for the

Business-Savvy!​

Let’s Connect

A 30 min no cost strategy session
with cloud support expert

Let’s Connect

A 30 min no cost strategy session
with cloud support expert