List campaigns
Campaigns with status, subject, list, how many contacts they were sent to and open and click rates.
GET https://cotlet.dev/api/v1/emailoctopus/campaigns
read
Returns campaigns the way the Campaigns tab lists them, newest first unless you sort. status filters to sent, scheduled or draft. search matches the campaign name or subject; prefix a term with name: or subject: to search one of them. sort is name, date, open_rate, click_rate or sent. date is the day the campaign was sent, or scheduled for, or created for a draft. Pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | all, sent, scheduled or draft. Default: all. |
| search string | string | Text in the campaign name or subject; name: or subject: limits the search. |
| sort enum | enum | date, name, open_rate, click_rate or sent. Default: date. |
| order enum | enum | asc or desc. Default: desc. |
| cursor string | string | next_cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/emailoctopus/campaigns \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("emailoctopus", "list_campaigns")const result = await cotlet.call('emailoctopus', 'list_campaigns');cotlet call emailoctopus list_campaignsExample response
{
"campaigns": [
{
"campaign_id": "c7a41b92-0d3e-4f58-b6a1-2e9d8c5f7014",
"name": "Autumn offer",
"subject": "Autumn offer: 20% off the new menu",
"status": "sent",
"list": "Newsletter",
"sent_to": 1840,
"open_rate": 38.2,
"click_rate": 5.2,
"date": "2026-10-14"
},
{
"campaign_id": "a2f9d6e3-81b4-4c07-9e5a-7d1c3b8f2e60",
"name": "Weekly newsletter",
"subject": "This week at Northside",
"status": "scheduled",
"list": "Newsletter",
"sent_to": null,
"open_rate": null,
"click_rate": null,
"date": "2026-10-23"
}
],
"next_cursor": null
}