Newsletter Management

Build and maintain your email list for market updates and property newsletters.

Overview

The newsletter system allows you to:

• Collect email subscribers from your website
• Track subscription sources
• Manage subscriber list
• Export subscribers for email campaigns
• View subscription analytics

Subscription Forms

Newsletter signup forms appear in several locations:

• Footer — Persistent signup on all pages
• Blog posts — Inline call-to-action
• Popups — Exit intent or timed popups (if enabled)

Subscriber Statuses

Status	Description
Active	Subscribed and receiving emails
Unsubscribed	Opted out via unsubscribe link
Bounced	Email address invalid or rejected

Managing Subscribers

Viewing Subscribers

Navigate to Admin → Newsletter to see:

• List of all subscribers
• Status and source for each
• Subscription date
• Unsubscribe date/feedback (if applicable)

Filtering Subscribers

Filter the list by:

• Status — Active, unsubscribed, bounced
• Source — Where they signed up
• Date range — Subscribed within timeframe

Exporting Subscribers

Click Export to download a CSV of active subscribers for:

• Mailchimp import
• Constant Contact
• Other email marketing platforms

Exported fields:

• Email address
• Subscription date
• Source

Analytics Dashboard

The newsletter dashboard shows:

Metric	Description
Total Subscribers	All-time signups
Active Subscribers	Currently subscribed
Unsubscribed	Total opt-outs
This Week	New signups in last 7 days
This Month	New signups in last 30 days
By Source	Breakdown by signup location

Unsubscribe Process

When a subscriber clicks “Unsubscribe” in an email:

1. They’re shown a confirmation page
2. Optional feedback field asks why they’re leaving
3. One-click confirmation removes them from list
4. Feedback is stored for analysis

Viewing Unsubscribe Feedback

Admin → Newsletter → Filter by “Unsubscribed” to see:

• When they unsubscribed
• Their feedback (if provided)

Use this feedback to improve email content and frequency.

Source Tracking

Track where subscribers come from:

Source	Description
footer	Site-wide footer form
blog	Blog post inline signup
popup	Exit intent/timed popup
landing	Dedicated landing page
api	Direct API integration

Add source tracking by including source parameter when subscribing.

API Endpoints

Public Endpoints

Action	Method	Endpoint
Subscribe	POST	/api/v1/newsletter/subscribe
Unsubscribe (page)	GET	/api/v1/newsletter/unsubscribe/{token}
Unsubscribe (confirm)	POST	/api/v1/newsletter/unsubscribe/{token}

Admin Endpoints (requires auth)

Action	Method	Endpoint
List subscribers	GET	/api/v1/newsletter/subscribers
Get stats	GET	/api/v1/newsletter/stats
Export CSV	GET	/api/v1/newsletter/export

Subscribe Request Example

{
  "email": "subscriber@example.com",
  "source": "blog"
}

Best Practices

1. Use double opt-in — Confirm email addresses are valid
2. Segment by source — Tailor content to how they found you
3. Monitor unsubscribes — High rates indicate content issues
4. Regular cleaning — Remove bounced emails promptly
5. Value-first content — Market updates, not just listings
6. Consistent schedule — Weekly or bi-weekly is ideal

Compliance

The newsletter system is designed for compliance:

• Unsubscribe link in every email
• One-click unsubscribe (no login required)
• Feedback collection for improvement
• No sharing of subscriber data
• Source tracking for audit trails