Skip to main content

Common Campaign Error Codes

When sending email campaigns, you may occasionally encounter error messages. This guide explains the most common campaign errors, their causes, and how to resolve them.

No Contacts to Process​

Error Message: "Campaign has no contacts to process for any of its groups"

Cause: This error occurs when you've created a campaign but the selected groups contain no valid contacts who can receive your message.

Resolution:

  1. Check that your selected groups contain contacts
  2. Verify that contacts in these groups have valid contact information (email addresses for email campaigns, phone numbers for SMS campaigns)
  3. Consider creating a new segment with valid contacts

Invalid Contact Data​

Error Message: "Contact [ID] has no primary email address"

Cause: The campaign includes contacts who don't have a primary email address assigned.

Resolution:

  1. Update contact records to include primary email addresses
  2. Create a segment that filters for contacts with email addresses
  3. Use contact validation tools to identify incomplete records

Unvalidated Email Addresses​

Error Message: "Contact [ID] primary email is not validated"

Cause: Contacts in your campaign have email addresses that haven't been validated yet.

Resolution:

  1. Run the email validation process on your contact list
  2. Create a segment that only includes contacts with validated emails
  3. Remove unvalidated emails from your campaign segments

Contact Communication Preferences​

Error Message: "Contact [ID] is not allowed to receive email"

Cause: Some contacts in your campaign have the "don't send email" flag enabled in their preferences.

Resolution:

  1. Respect these preferences and exclude these contacts from campaigns
  2. Create segments that filter out contacts who have opted out of communications
  3. Review your opt-in procedures to ensure clear consent

Template Formatting Issues​

Error Message: "Template formatting issue"

Cause: The selected template contains merge tags or formatting that cannot be properly compiled.

Resolution:

  1. Check your template for broken or incorrect merge tags
  2. Test the template with a sample contact
  3. Verify that all merge tags reference valid contact fields

Error Message: "No unsubscribe link found. Force added one at the end of the template"

Cause: Your email template doesn't include the required unsubscribe link.

Resolution:

  1. Add {{contact.unsubscribe_token}} to your template
  2. Use the standard unsubscribe link format in your template footer
  3. Check campaign preview to verify the unsubscribe link appears correctly

Account Limit Errors​

Daily Sending Limit​

Error Message: "Daily send limit would be reached by this campaign" or "Max daily send limit reached"

Cause: Your campaign would exceed your account's daily email sending limit.

Resolution:

  1. Reduce the size of your campaign
  2. Split the campaign into smaller batches sent over multiple days
  3. Upgrade your plan to increase your daily sending limits
  4. Wait until the daily metrics reset (occurs automatically every 24 hours)

Monthly Sending Limit​

Error Message: "Monthly send limit would be reached by this campaign" or "Max monthly send limit reached"

Cause: Your campaign would exceed your account's monthly email sending limit.

Resolution:

  1. Reduce the size of your campaign
  2. Delay some campaigns until the next billing cycle
  3. Upgrade your subscription to increase monthly limits
  4. Wait until the monthly metrics reset (occurs automatically each month)

Email Quality Issues​

Error Message: "Max complaints reached"

Cause: Your account has reached the maximum allowed complaint rate for email sends. This occurs when recipients mark your emails as spam.

Resolution:

  1. Review your email content for spam triggers
  2. Ensure your contact list consists of people who have opted in
  3. Implement a sunset policy for unengaged contacts
  4. Wait until the daily complaint metric resets

Error Message: "Max bounces reached"

Cause: Your account has reached the maximum allowed bounce rate for email sends. This occurs when emails cannot be delivered due to invalid addresses.

Resolution:

  1. Clean your contact list to remove invalid email addresses
  2. Implement regular email validation processes
  3. Remove contacts with a history of bounces
  4. Wait until the daily bounce metric resets

Inactive Subscription​

Error Message: "Subscription is not active for this company" or "Company subscription is not active"

Cause: Your account's subscription is not active, preventing campaign sending.

Resolution:

  1. Check your subscription status in billing settings
  2. Update payment information if necessary
  3. Contact customer support to resolve subscription issues

Email Features Disabled​

Error Message: "Email is disabled for company"

Cause: The email feature has been disabled for your company account. This can happen for several reasons:

  1. Manual Administrative Action: An administrator may have disabled email sending for your account
  2. Automatic Disabling Due to Bounces: The system automatically disables email when your account exceeds the maximum allowed bounce rate
  3. Automatic Disabling Due to Complaints: The system automatically disables email when your account exceeds the maximum allowed complaint rate

How automatic disabling works:

  • Each account has configurable thresholds for daily bounce and complaint rates
  • The system continuously monitors these metrics for all outgoing emails
  • When either metric exceeds your account's threshold, a safety mechanism is triggered
  • This safety feature automatically disables email sending for your account
  • The system records the reason for disabling (either "Bounce Limit Exceeded" or "Complaint Limit Exceeded")

Understanding bounce and complaint metrics:

  • Bounces: Occur when emails cannot be delivered to the recipient's inbox
  • Complaints: Occur when recipients mark your emails as spam
  • The system tracks these metrics daily and resets them every 24 hours
  • When either metric exceeds your account's threshold, email sending is automatically disabled

Resolution:

  1. Review your bounce and complaint reports to identify problematic contacts or email content
  2. Clean your contact lists to remove invalid email addresses
  3. Improve email content to reduce the likelihood of spam complaints
  4. Wait for the daily metrics to reset (happens automatically every 24 hours)
  5. Contact support to request manual re-enabling of your email feature
  6. Consider implementing better email validation practices to prevent future issues

Missing Company Information​

Error Message: "Company is missing or no subscription or no metrics"

Cause: The system cannot find necessary company information, subscription details, or metrics needed to process your campaign.

Resolution:

  1. Verify your company profile is complete
  2. Confirm you have an active subscription
  3. Contact support if you believe this is an error in the system

Pending Imports​

Error Message: "At least one group had a pending import at action build time"

Cause: You're trying to send a campaign to a group that still has contacts being imported.

Resolution:

  1. Wait for all imports to complete before sending the campaign
  2. Check import status in the Groups section
  3. The system will automatically retry this campaign once imports are complete

Technical Errors​

Invalid Action Type​

Error Message: "Campaign tried to build action on a [Action Type]"

Cause: The campaign is attempting to use an action type that isn't supported for campaigns.

Resolution:

  1. Select a valid campaign action type (Email, SMS, Postcard)
  2. Contact support if you believe this is a system error

Invalid Template Reference​

Error Message: "[Type] Template with id [ID] is not valid"

Cause: The campaign references a template that doesn't exist or is invalid.

Resolution:

  1. Select a different template for your campaign
  2. Verify that the template hasn't been deleted
  3. Create a new template if needed

Best Practices to Avoid Errors​

Pre-Campaign Checklist​

  • Validate your contact list before sending
  • Test your template with a sample contact
  • Verify that all selected groups contain valid contacts
  • Check that you have sufficient sending capacity in your plan
  • Ensure all imports are completed before scheduling

Regular Maintenance​

  • Clean your contact database regularly
  • Remove invalid email addresses
  • Update contact preferences based on engagement
  • Archive old or unused templates
  • Monitor your sending reputation

When to Contact Support​

If you encounter persistent errors not covered in this guide, contact support with:

  1. The campaign ID (found in the campaign URL)
  2. The specific error message
  3. Steps you've already taken to resolve the issue
  4. Screenshots of the error if available