<aside> 🐝 For Beehiiv-based newsletters, this step is not necessary (it’s fully automated).

</aside>

If your ESP’s API doesn’t support pulling engagement data, you can manually upload engagement data via the Subscribers tab (Upload engagement button).

You can upload a CSV file with the following columns:

• email
• engagement_status with the following values:
  • engaged

  1. Hard confirmation email

     You don’t send your newsletter unless the subscriber confirmed their subscription explicitly.

     • unengaged_unconfirmed

  2. Otherwise (most common case)

     You may or may not send a confirmation or welcome email but regardless of the subscriber’s interaction, you start sending your regular email.

     • unengaged_no_open: the subscriber did not open any email in their first 7 days
     • unengaged_unsubscribe: the subscriber unsubscribed in their first 7 days
     • unengaged_bounce: the email bounced in their first 7 days, i.e., you were not able to reach their inbox
     • unengaged_complaint: the subscriber sent a complaint in their first 7 days

Examples

1. Hard confirmation email (edge case)

   email	engagement_status
   [email protected]	unengaged_unconfirmed	they didn’t confirm so they don’t get any content email from you
   [email protected]	unengaged_unconfirmed	they didn’t confirm so they don’t get any content email from you

2. Otherwise (most common case)

   email	engagement_status	comment
   [email protected]	unengaged_no_open	they did not open any email from d0-d7
   [email protected]	unengaged_unsubscribe	they unsubscribed before d7
   [email protected]	unengaged_bounce	your email bounced before d7
   [email protected]	unengaged_complaint	they sent an email complaint before d7

Timeline

You can upload engagement data anytime for subscribers of the current invoicing period that joined at least 7 days ago. You don’t need to upload multiple times a month – it’s enough to do it once on the 7th of the month for all subscribers of the current invoicing period.