Campaigns

List campaigns

Lists campaigns for the authenticated company, optionally filtered by status or label.

get/campaigns

Query parameters

status'draft' | 'scheduled' | 'sent' | 'sending' | 'cancelled' | 'paused' | 'waiting_approval'

Optional campaign status filter.

labelstring

Optional label name filter. Only campaigns assigned this label are returned.

Response

Campaigns returned

successboolean

Example response

{
  "success": true,
  "campaigns": [
    {
      "id": "camp_abc123",
      "name": "April Launch",
      "subject": "A quick update",
      "status": "draft",
      "labels": [
        "edm",
        "api"
      ]
    }
  ]
}

Changes