Newsletter campaigns let platform administrators send email broadcasts to subscribers. Use them for product announcements, feature launches, compliance updates, or any communication that goes to your full subscriber base.
Newsletter campaigns are a platform administration feature, separate from the AI CMO outbound engine. The AI CMO handles autonomous, personalized outreach to leads. Newsletter campaigns are manual, one-to-many broadcasts to subscribers. Prerequisites
Platform administrator access to the console
How it works
Build your subscriber list. Subscribers are added through your website, API integrations, or other acquisition channels. Manage them from the console.Compose a campaign. Write a subject line, preview text, and HTML email body. Preview the rendered email inline before sending.Test. Send a test email to any address to verify formatting and content.Send. Broadcast the campaign to all active subscribers. Delivery stats are tracked automatically.
Subscribers Viewing subscribers Open Newsletter in the platform console. The main page shows two sections:
Subscribers — a searchable, paginated list of all subscribers with their email, name, status, source, and subscription date.Campaigns — a list of all newsletter campaigns with their status and delivery stats.
Subscriber statuses Status Description ACTIVESubscribed and eligible to receive campaigns UNSUBSCRIBEDOpted out of communications BOUNCEDEmail delivery failed permanently
Removing a subscriber Click the delete icon next to any subscriber to remove them from the list. This action is permanent.
Managing subscribers via the API List subscribers curl -X GET https://api.truthlocks.com/v1/platform/newsletter/subscribers \ -H "X-API-Key: tl_live_your_api_key"
Each subscriber in the response includes:
Field Type Description idstring Unique subscriber identifier emailstring Subscriber’s email address namestring Subscriber’s display name statusstring ACTIVE, UNSUBSCRIBED, or BOUNCEDsourcestring How the subscriber was added (e.g. website, api) subscribed_atstring ISO 8601 timestamp
Get or update a subscriber # Get a subscriber curl -X GET https://api.truthlocks.com/v1/platform/newsletter/subscribers/{id} \ -H "X-API-Key: tl_live_your_api_key" # Update a subscriber curl -X PATCH https://api.truthlocks.com/v1/platform/newsletter/subscribers/{id} \ -H "X-API-Key: tl_live_your_api_key" \ -H "Content-Type: application/json" \ -d '{"name": "Updated Name", "status": "UNSUBSCRIBED"}' # Delete a subscriber curl -X DELETE https://api.truthlocks.com/v1/platform/newsletter/subscribers/{id} \ -H "X-API-Key: tl_live_your_api_key"
Campaigns Creating a campaign
Open the campaign editor
Navigate to Newsletter in the console and click New Campaign , or go to the campaigns section and click Create Campaign .
Compose the email
Fill in the campaign fields: Field Required Description Subject Yes The email subject line Preview text No Short summary that appears in email clients before opening Content Yes HTML email body — a live preview renders below the editor
Save as draft
Click Create Campaign to save. The campaign is created in DRAFT status.
Campaign statuses Status Description DRAFTNot yet sent — you can still edit the subject, preview text, and content SENDINGDelivery is in progress SENTSuccessfully delivered to subscribers FAILEDDelivery encountered an error
Editing a draft campaign Open a DRAFT campaign from the campaigns list. Update the subject, preview text, or HTML content, then click Save Changes . You can also delete a draft campaign entirely.
Sending a test email Before broadcasting to your full subscriber list, send a test email to verify the content renders correctly:
Open the campaign detail page.
Enter a test recipient email address.
Click Send Test .
The test email is delivered only to the address you specify — no subscribers receive it.
Broadcasting a campaign When you are ready to send to all active subscribers:
Open the campaign detail page.
Click Send to All Subscribers .
Confirm in the dialog that appears.
Sending is irreversible. Once confirmed, the campaign is delivered to every active subscriber. Always send a test email first to verify formatting.
After sending, the campaign status changes to SENT and the detail page shows delivery stats:
Metric Description Sent Number of emails successfully delivered Failed Number of delivery failures Sent at Timestamp when the broadcast completed
Managing campaigns via the API Create a campaign curl -X POST https://api.truthlocks.com/v1/platform/newsletter/campaigns \ -H "X-API-Key: tl_live_your_api_key" \ -H "Content-Type: application/json" \ -d '{ "subject": "March product update", "preview_text": "New features shipping this week", "content": "<h1>March Update</h1><p>Here is what shipped this month...</p>" }'
Field Type Required Description subjectstring Yes Email subject line preview_textstring No Preview text shown in email clients contentstring Yes HTML email body
List campaigns curl -X GET https://api.truthlocks.com/v1/platform/newsletter/campaigns \ -H "X-API-Key: tl_live_your_api_key"
Each campaign in the response includes:
Field Type Description idstring Unique campaign identifier subjectstring Email subject line preview_textstring Preview text statusstring DRAFT, SENDING, SENT, or FAILEDsent_countinteger Number of emails delivered failed_countinteger Number of delivery failures created_atstring ISO 8601 timestamp sent_atstring or null ISO 8601 timestamp when the broadcast completed
Get, update, or delete a campaign # Get a campaign curl -X GET https://api.truthlocks.com/v1/platform/newsletter/campaigns/{id} \ -H "X-API-Key: tl_live_your_api_key" # Update a draft campaign curl -X PATCH https://api.truthlocks.com/v1/platform/newsletter/campaigns/{id} \ -H "X-API-Key: tl_live_your_api_key" \ -H "Content-Type: application/json" \ -d '{"subject": "Updated subject line"}' # Delete a campaign curl -X DELETE https://api.truthlocks.com/v1/platform/newsletter/campaigns/{id} \ -H "X-API-Key: tl_live_your_api_key"
Send a test email curl -X POST https://api.truthlocks.com/v1/platform/newsletter/campaigns/{id}/test \ -H "X-API-Key: tl_live_your_api_key" \ -H "Content-Type: application/json" \ -d '{"test_email": "you@example.com"}'
Send to all subscribers curl -X POST https://api.truthlocks.com/v1/platform/newsletter/campaigns/{id}/send \ -H "X-API-Key: tl_live_your_api_key"
This broadcasts to every active subscriber and cannot be undone.
AI CMO Autonomous outbound campaigns with AI-driven lead discovery and personalized emails.
Email delivery Email infrastructure, templates, and delivery configuration.
