For ContractorsPlansBuildersFor HomeownersFor BuildersPricingHelpSearchAcademyStart Free Trial

Marketing Inbox — Email Threading & Replies

Review, respond to, and manage replies from Apollo outreach campaigns with email threading and attachment support

On this page

OverviewAccessing the InboxUnderstanding Thread StatusReplying to ContractorsAssigning ThreadsEmail ThreadingCustomizing Email BrandingFiltering and SearchingBest PracticesTroubleshooting

Overview

The Marketing Inbox shows all email replies from contractors you've reached out to via Apollo outreach campaigns. Review new responses, assign conversations to team members, update lead status based on interest level, and reply directly from the inbox - keeping all outreach communication centralized. Email replies automatically thread back to the original outreach message, and you can attach files when responding to provide additional context or materials.

NEW: Customizable Email Branding - The marketing inbox now respects environment variable overrides for sender name, from email, font family, signature text, and mailing address when sending replies. Configure MARKETING_FROM_NAME, MARKETING_FROM_EMAIL, MARKETING_EMAIL_FONT, MARKETING_SIGNATURE_TEXT, and MARKETING_MAILING_ADDRESS in your environment to customize the branding of outbound marketing emails without code changes.

NEW: Admin Session Required - The Marketing Inbox now requires an active admin session to access. If your session expires, you'll be redirected to the admin login page at /admin/login. This ensures secure access to sensitive marketing conversations and lead data.

NEW: Error Protection & Loading States - The inbox now gracefully handles database errors during initial load. If the marketing database tables aren't ready yet (during first-time setup or after schema changes), the page loads successfully with an empty thread list and shows a yellow warning banner: "Marketing inbox is initializing." This prevents 500 errors and allows you to continue using BlueClerk while the marketing system spins up.

Accessing the Inbox

  1. Log in with an admin account
  2. Ensure your session is active - you'll be redirected to login if expired
  3. Navigate to Admin > Marketing > Inbox
  4. View all conversation threads from Apollo outreach

Understanding Thread Status

Status Types

  • NEW - Contractor replied, needs your review
  • ASSIGNED - Thread assigned to a team member
  • REPLIED - You've responded to the contractor
  • CLOSED - Conversation is complete or unqualified

How Status Updates Work

  • Manual status changes - Click the status dropdown on any thread to change it
  • Automatic status changes - When you send a reply, status auto-updates to REPLIED
  • Lead status sync - Changing thread status can optionally update the linked lead's status

Replying to Contractors

Composing a Reply

  1. Click a thread from the inbox list
  2. Review the conversation - see all messages in chronological order
  3. Click "Reply" at the bottom of the thread
  4. Write your message in the compose box
  5. Optionally attach files - click the paperclip icon to add PDFs, images, or documents
  6. Click "Send" to deliver your reply via AWS SES

How Replies Work

  • Sent from your marketing address - Uses MARKETING_FROM_EMAIL (default: hello@blueclerk.com) or environment override
  • Sender name - Uses MARKETING_FROM_NAME (default: "Chris at BlueClerk") or environment override
  • Reply-To threading - Built using buildMarketingReplyAddress to ensure responses thread back to the conversation
  • Unsubscribe footer - Automatically added to all replies with working unsubscribe link
  • Font styling - Uses MARKETING_EMAIL_FONT (default: Roboto) or environment override
  • Signature - Uses MARKETING_SIGNATURE_TEXT or environment override if set
  • Mailing address - Uses MARKETING_MAILING_ADDRESS or environment override if set

Assigning Threads

Assigning to Team Members

  1. Open a thread you want to assign
  2. Click the "Assign to" dropdown
  3. Select a team member from your admin users
  4. Status auto-updates to ASSIGNED
  5. Assigned member is notified (if notifications are enabled)

Why Assign Threads

  • Delegate follow-up - Let SDRs or sales reps handle specific conversations
  • Track ownership - See who's responsible for each lead
  • Balance workload - Distribute incoming replies across your team

Email Threading

How Threading Works

When contractors reply to your outreach emails:

  1. Reply is received at the trackable reply address
  2. Thread is automatically identified using the conversation ID in the reply-to address
  3. New message is added to the existing conversation chronologically
  4. Thread status updates to NEW if it was previously CLOSED or REPLIED
  5. You see the full conversation in the inbox with all messages in order

Benefits of Threading

  • Complete context - See the entire email exchange in one place
  • No lost messages - All replies are captured and organized
  • Easy follow-up - Review the full conversation before responding

Customizing Email Branding

Environment Variables

Configure these environment variables to customize your marketing email branding:

  • MARKETING_FROM_EMAIL - Sender email address (default: hello@blueclerk.com)
  • MARKETING_FROM_NAME - Sender display name (default: "Chris at BlueClerk")
  • MARKETING_EMAIL_FONT - Font family key (roboto, arial, system, georgia - default: roboto)
  • MARKETING_SIGNATURE_TEXT - Custom signature text (supports \n for line breaks)
  • MARKETING_MAILING_ADDRESS - Physical mailing address for CAN-SPAM compliance (supports \n for line breaks)

Example Configuration

MARKETING_FROM_EMAIL=outreach@yourcompany.com
MARKETING_FROM_NAME=Sarah at YourCompany
MARKETING_EMAIL_FONT=arial
MARKETING_SIGNATURE_TEXT=Best regards,\nSarah Smith\nHead of Partnerships
MARKETING_MAILING_ADDRESS=123 Business St\nSuite 200\nAustin, TX 78701

How Overrides Work

  • Per-company branding not supported - All marketing emails use the same environment-level branding
  • Fallback to defaults - If environment variables aren't set, system defaults are used
  • Signature appears in all emails - Both outreach and reply emails include the configured signature
  • Mailing address in footer - Appears after signature for CAN-SPAM compliance

Filtering and Searching

Filter by Status

Use the status filter dropdown to view:

  • All threads - Every conversation regardless of status
  • NEW only - Unread contractor replies
  • ASSIGNED only - Threads delegated to team members
  • REPLIED only - Conversations you've responded to
  • CLOSED only - Completed or disqualified threads

Search Threads

Use the search box to find threads by:

  • Contractor company name
  • Contact name
  • Email address
  • Message content

Best Practices

Response Timing

  • Reply quickly to NEW threads - Respond within 24 hours when possible
  • Set expectations - If you need time to research, send a quick acknowledgment
  • Use templates - Save common responses for faster replies

Lead Qualification

  • Update lead status - Mark leads as qualified, contacted, or converted based on conversation
  • Close dead threads - Mark threads CLOSED when leads are unqualified or unresponsive
  • Track conversion - Use lead status to measure outreach effectiveness

File Attachments

  • Send helpful resources - Attach case studies, pricing sheets, or product demos
  • Keep files small - Under 10MB for reliable delivery
  • Use descriptive names - Help recipients understand what they're downloading

Troubleshooting

Thread Not Appearing

If a contractor's reply doesn't show up:

  • Check spam folder - Their reply may have been filtered
  • Verify reply-to address - Ensure they replied to the trackable address, not a personal email
  • Wait for sync - Email processing can take a few minutes

Reply Not Sending

If your reply fails to send:

  • Check AWS SES status - Ensure your SES account is active and verified
  • Verify sender email - MARKETING_FROM_EMAIL
Was this helpful?
Contact Support →