List campaigns

Your team's campaigns with title, state, sender and number of emails in the sequence.

GET https://cotlet.dev/api/v1/mailshake/campaigns

read

Lists the campaigns of your Mailshake team, 100 to a page. is_paused and is_archived show the state; an archived campaign has to be unarchived in the Mailshake app before most other tools work on it. Pass next_token back to get the next page; it is null on the last page. Use id as campaign_id in the other tools.

Parameters

Parameters: list_campaigns
NameTypeDescription
search string string Only campaigns whose title matches this text.
per_page integer integer 1 to 100. Default: 100.
next_token string string Next page token from the previous call.

Request

cURL
curl https://cotlet.dev/api/v1/mailshake/campaigns \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("mailshake", "list_campaigns")
Node.js
const result = await cotlet.call('mailshake', 'list_campaigns');
CLI
cotlet call mailshake list_campaigns

Example response

JSON

{
  "results": [
    {
      "id": 4821,
      "title": "Agency outreach Q4",
      "is_paused": false,
      "is_archived": false,
      "sender": "sam@northwind.example",
      "emails_in_sequence": 3,
      "created": "2026-10-02T09:14:00.000Z"
    },
    {
      "id": 4790,
      "title": "Webinar follow-up",
      "is_paused": true,
      "is_archived": false,
      "sender": "sam@northwind.example",
      "emails_in_sequence": 2,
      "created": "2026-09-18T12:40:00.000Z"
    }
  ],
  "next_token": null
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.