---
title: "List Campaigns"
method: GET
path: "/user/campaigns"
tags: ["Campaigns"]
---

# List Campaigns

`GET /user/campaigns`

## Request

- Base URL: `https://app.famulor.de/api`
- URL: `https://app.famulor.de/api/user/campaigns`
- Auth: HTTP bearer

List all campaigns (call, WhatsApp, SMS) in your Famulor account via API. View channel, schedule windows, WhatsApp/SMS config, and optional call→text fallback settings.

[Docs](https://docs.famulor.io/api-v1/campaigns/list)

## Response `200`

Response

- object[]
  - `array` object[]: Array of all campaigns
    - `id` integer: Campaign ID
    - `name` string: Campaign name
    - `channel` string: `call`, `whatsapp`, or `sms`
    - `status` string: e.g. `draft`, `scheduled`, `in-progress`, `paused`, `completed`
    - `assistant_id` integer: OUTBOUND assistant ID (call campaigns). `null` for text campaigns.
    - `timezone` string: IANA timezone for the send/call window
    - `max_calls_in_parallel` integer: Concurrent call slots (call campaigns)
    - `messages_per_minute` integer: Per-campaign text send rate (WhatsApp/SMS). WhatsApp also uses a user-wide in-flight pool of 10.
    - `schedule_windows` unknown[]: Daily windows `[{ "start": "HH:MM", "end": "HH:MM" }]`. Overnight allowed when `end` < `start`.
      - unknown
    - `scheduled_start_at` string: ISO datetime for auto-start, or `null`
    - `allowed_hours_start_time` string: Legacy window start (kept in sync with the first schedule window)
    - `allowed_hours_end_time` string: Legacy window end
    - `allowed_days` unknown[]: Weekdays when sending/calling is allowed
      - unknown
    - `max_retries` integer: Max retries per lead
    - `retry_interval` integer: Minutes between retries
    - `retry_on_voicemail` boolean: Call campaigns: retry on voicemail
    - `retry_on_goal_incomplete` boolean: Call campaigns: retry until goal variable is true
    - `goal_completion_variable` string: Boolean post-call variable name, or `null`
    - `mark_complete_when_no_leads` boolean: Auto-complete when no work remains
    - `phone_number_ids` unknown[]: Outbound from-number IDs (call campaigns)
      - unknown
    - `whatsapp_sender_id` integer: WhatsApp sender ID, or `null`
    - `whatsapp_template_id` integer: WhatsApp template ID, or `null`
    - `sms_from_phone_number_id` integer: SMS from-number ID, or `null`
    - `sms_body` string: SMS body, or `null`
    - `text_variable_mapping` object: WhatsApp template placeholder → lead variable map, or `null`
    - `fallback_channel` string: Call→text fallback channel (`whatsapp` / `sms`), or `null`
    - `fallback_whatsapp_sender_id` integer: Fallback WhatsApp sender, or `null`
    - `fallback_whatsapp_template_id` integer: Fallback WhatsApp template, or `null`
    - `fallback_sms_from_phone_number_id` integer: Fallback SMS from-number, or `null`
    - `fallback_sms_body` string: Fallback SMS body, or `null`
    - `fallback_variable_mapping` object: Fallback WhatsApp variable map, or `null`
    - `created_at` string: Created timestamp in your account timezone
    - `updated_at` string: Updated timestamp in your account timezone

## Other responses

- `401`: Fehlender oder ungültiger API-Key.
- `422`: Die Anfrage ist inhaltlich ungültig.

---

[API](https://skmtc.dev/famulor/apis/famulor-api.md) · [All operations](https://skmtc.dev/famulor/apis/famulor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/famulor/apis/famulor-api/revisions/3b938c370721?raw)