Campaigns

import com.lettr.Lettr;
import com.lettr.services.campaigns.model.*;

Lettr lettr = new Lettr("your-api-key");

ListCampaignsResponse campaigns = lettr.campaigns().list();

// With filters
ListCampaignsResponse drafts = lettr.campaigns().list(
    ListCampaignsParams.builder()
        .status(CampaignStatus.DRAFT)
        .perPage(50)
        .build()
);

for (CampaignView c : drafts.getCampaigns()) {
    System.out.println(c.getName() + " - " + c.getStatus() + " (sent: " + c.getSentCount() + ")");
}
System.out.println("Page " + drafts.getPagination().getCurrentPage()
        + " of " + drafts.getPagination().getLastPage());

CampaignDetail campaign = lettr.campaigns().get("0193e6a8-1f3a-7c2a-b9e2-1aa1d2e5d3f0");

System.out.println("Status: " + campaign.getStatus());
System.out.println("HTML: " + campaign.getHtmlContent());  // null for drafts with no rendered content yet

CampaignStats stats = campaign.getStats();
System.out.println("Opens: " + stats.getUniqueOpens() + " / Clicks: " + stats.getUniqueClicks());

String cursor = null;
do {
    ListCampaignEventsResponse page = lettr.campaigns().listEvents(
        campaign.getId(),
        ListCampaignEventsParams.builder()
            .eventType(CampaignEventType.CLICK)
            .startDate("2026-05-01")
            .limit(100)
            .cursor(cursor)
            .build()
    );

    for (CampaignEvent event : page.getEvents()) {
        System.out.println(event.getEventType() + " at " + event.getTimestamp()
                + " -> " + event.getTargetLinkUrl());
    }

    cursor = page.getNextCursor();
} while (cursor != null);

// Immediately dispatches a draft; the campaign transitions to "preparing".
CampaignView sending = lettr.campaigns().send(campaign.getId());

// Schedule (or reschedule) for future delivery. Include a timezone offset.
CampaignView scheduled = lettr.campaigns().schedule(
    campaign.getId(),
    ScheduleCampaignOptions.of("2026-06-01T09:00:00+00:00")
);

// Cancel a scheduled send, returning the campaign to "draft".
CampaignView draft = lettr.campaigns().unschedule(campaign.getId());