# List campaigns

`GET https://app.whatsetter.com/api/v1/campaigns`

The workspace's campaigns: use `campaign_id` to filter `/leads` and
`/conversations`, `channels` to know where each agent talks
(WhatsApp, Instagram, Messenger) and `whatsapp_connected` to know
whether its WhatsApp number can currently send. Requires scope
`campaigns:read`.

## Example request

```bash
curl --request GET \
  --url 'https://app.whatsetter.com/api/v1/campaigns' \
  --header 'Authorization: Bearer ws_live_…'
```

## Responses

### 200: The workspace's campaigns

```json
{
  "data": [
    {
      "id": "",
      "campaign_id": "",
      "name": "",
      "agent_name": "",
      "status": "active",
      "purpose": "setter",
      "channels": [
        "whatsapp"
      ],
      "whatsapp_connected": false,
      "knowledge_base_id": "",
      "created_at": ""
    }
  ]
}
```

### 401: Missing, unknown or revoked API key

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```

### 403: The key lacks the required scope (`insufficient_scope`), the plan does not have this part of the API (`not_in_plan`), or Instagram is not enabled on the workspace (`instagram_not_enabled`, Instagram routes)

```json
{
  "error": {
    "code": "",
    "message": ""
  }
}
```


Source: https://docs.whatsetter.com/api-reference/operations/listcampaigns/
