Campaigns list - Seleqt API

GET /api/v1/campaigns/

Returns a list of campaigns with optional workspace filtering. Authentication: Session-based (JWT Cookie) OR API Key (X-API-Key header)

Query Parameters

workspace_id (string, optional): Filter campaigns by workspace
- Omit parameter: Returns campaigns from current workspace
- workspace_id=123: Returns campaigns from workspace 123 (if user has access)
- workspace_id=ALL: Returns campaigns from all workspaces user has access to

Security

Users can only access campaigns from workspaces they are linked to via linked_workspaces.

Response

{
  "campaigns": [
    {
      "id": 123,
      "name": "My Campaign",
      "status": "ACTIVE",
      "workspace_id": 340,
      "timezone": "Europe/Amsterdam",
      "language": "en",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z",
      "prospect_count": 150
    }
  ]
}

Examples

Using API Key (recommended for integrations):

# Get campaigns from current workspace
curl -X GET "https://app.seleqt.ai/api/v1/campaigns/" \
  -H "X-API-Key: your_api_key_here"

# Get campaigns from specific workspace
curl -X GET "https://app.seleqt.ai/api/v1/campaigns/?workspace_id=340" \
  -H "X-API-Key: your_api_key_here"

# Get campaigns from all workspaces
curl -X GET "https://app.seleqt.ai/api/v1/campaigns/?workspace_id=ALL" \
  -H "X-API-Key: your_api_key_here"

Using Session Cookie (for web apps):

curl -X GET "https://app.seleqt.ai/api/v1/campaigns/" \
  -H "Cookie: sessionid=your_session_id"

Error Responses

403 Forbidden - User doesn’t have access to specified workspace:

{
  "error": "Access denied"
}