Skip to Content
Transactional Emails
Troubleshooting

Troubleshooting

Template Not Rendering Correctly

Issue: Variables show as {{variable_name}} instead of values

Solutions:

  • Verify you’re passing dynamicData in your API request
  • Ensure the dynamic data is a valid JSON object
  • Check for typos in variable names

Issue: HTML/CSS not displaying properly

Solutions:

  • Test in multiple email clients (Gmail, Outlook, etc.)
  • Use inline styles instead of <style> tags when possible
  • Avoid external CSS files
  • Use tables for layout instead of divs
  • Check for unclosed HTML tags

Template Not Found Error

Error Response:

{"success": false, "message": "Template not found", "code": "TEMPLATE_NOT_FOUND"}

Solutions:

  • Verify the Template ID is correct
  • Ensure the template belongs to your project
  • Check that the template hasn’t been deleted
  • Confirm you’re using the correct API key for the project

Subject Line Missing

Error: Validation error when saving template

Solutions:

  • Subject line is required for all templates
  • Add a subject line in the code editor
  • Subject can include dynamic variables: Order #{{ order_id }} Confirmed

Test Email Not Sending

Issue: Cannot send test emails from dashboard

Solutions:

  • Verify you have at least one verified domain in your project
  • Check that you’ve entered valid recipient email addresses
  • Ensure your template has both a subject and HTML content
  • Try with fewer recipients (maximum 5 for test emails)

Dynamic Data Not Updating Preview

Issue: Preview shows old data

Solutions:

  • Check that Test Variables JSON is valid (no syntax errors)
  • Ensure variables match those used in template
  • Try refreshing the page
  • Clear your browser cache