Skip to content
Dashboard

List campaigns

GET
/campaigns
curl --request GET \
--url https://app.whatsetter.com/api/v1/campaigns \
--header 'Authorization: Bearer <token>'

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.

The workspace’s campaigns

Media typeapplication/json
object
data
Array<object>
object
id
string
campaign_id

The value used by /leads?campaign_id= and lead objects.

string | null
name
string | null
agent_name

The first name the agent signs with (what people call it).

string | null
status

unknown for an internal value outside this list.

string | null
Allowed values: active draft paused archived unknown
purpose

setter = 1:1 conversations; group = a WhatsApp group campaign (its participants are left out of /leads unless filtered). unknown for an internal value outside this list.

string | null
Allowed values: setter group unknown
channels

Where the agent talks: WhatsApp, Instagram (an account answers with it), Messenger (facebook: a Facebook Page answers with it).

Array<string>
Allowed values: whatsapp instagram facebook
whatsapp_connected

Whether its WhatsApp number can send right now (false for an agent that only talks on Instagram or Messenger).

boolean
knowledge_base_id

The knowledge base this agent answers from (GET /knowledge-bases/{id}).

string | null
created_at
string format: date-time
Example
{
"data": [
{
"status": "active",
"purpose": "setter",
"channels": [
"whatsapp"
]
}
]
}

Missing, unknown or revoked API key

Media typeapplication/json
object
error
object
code
string
message
string
Examplegenerated
{
"error": {
"code": "example",
"message": "example"
}
}

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)

Media typeapplication/json
object
error
object
code
string
message
string
Examplegenerated
{
"error": {
"code": "example",
"message": "example"
}
}