Campaigns

import lettr "github.com/lettr-com/lettr-go"

client := lettr.NewClient("your-api-key")

campaigns, err := client.Campaigns.List(ctx, &lettr.ListCampaignsParams{
    Status:  lettr.CampaignStatusSent,
    Page:    1,
    PerPage: 20,
})

campaign, err := client.Campaigns.Get(ctx, "campaign-id")

params := &lettr.ListCampaignEventsParams{
    EventType: lettr.CampaignEventTypeClick,
    Limit:     50,
}
for {
    page, err := client.Campaigns.ListEvents(ctx, "campaign-id", params)
    if err != nil {
        return err
    }
    for _, event := range page.Data.Events {
        // ... process each event
        _ = event
    }
    if page.Data.NextCursor == nil {
        break
    }
    params.Cursor = *page.Data.NextCursor
}

// Send a draft campaign now (asynchronous; transitions to "preparing")
sent, err := client.Campaigns.Send(ctx, "campaign-id")

// Schedule for future delivery — ISO 8601 with a timezone offset.
// Calling Schedule again on a scheduled campaign reschedules it.
scheduled, err := client.Campaigns.Schedule(ctx, "campaign-id", &lettr.ScheduleCampaignRequest{
    ScheduledAt: "2026-06-01T09:00:00+00:00",
})

// Cancel a scheduled send, returning the campaign to draft
_, err = client.Campaigns.Unschedule(ctx, "campaign-id")