> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Campaigns

> 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.

<Warning>
  **Famulor 1.0 API (legacy).** This page applies only to Famulor 1.0 (`app.famulor.de`) and is retained for legacy compatibility. For the current platform, use the [Famulor 2.0 API reference](/api-reference/introduction).
</Warning>

Returns every campaign you own, including channel, schedule windows, WhatsApp/SMS config, and optional call→text fallback settings.

### Response

Returns a JSON array of campaign objects.

<ResponseField name="array" type="array">
  Array of all campaigns

  <Expandable title="Campaign Properties">
    <ResponseField name="id" type="integer">
      Campaign ID
    </ResponseField>

    <ResponseField name="name" type="string">
      Campaign name
    </ResponseField>

    <ResponseField name="channel" type="string">
      `call`, `whatsapp`, or `sms`
    </ResponseField>

    <ResponseField name="status" type="string">
      e.g. `draft`, `scheduled`, `in-progress`, `paused`, `completed`
    </ResponseField>

    <ResponseField name="assistant_id" type="integer">
      OUTBOUND assistant ID (call campaigns). `null` for text campaigns.
    </ResponseField>

    <ResponseField name="timezone" type="string">
      IANA timezone for the send/call window
    </ResponseField>

    <ResponseField name="max_calls_in_parallel" type="integer">
      Concurrent call slots (call campaigns)
    </ResponseField>

    <ResponseField name="messages_per_minute" type="integer">
      Per-campaign text send rate (WhatsApp/SMS). WhatsApp also uses a user-wide in-flight pool of 10.
    </ResponseField>

    <ResponseField name="schedule_windows" type="array">
      Daily windows `[{ "start": "HH:MM", "end": "HH:MM" }]`. Overnight allowed when `end` \< `start`.
    </ResponseField>

    <ResponseField name="scheduled_start_at" type="string">
      ISO datetime for auto-start, or `null`
    </ResponseField>

    <ResponseField name="allowed_hours_start_time" type="string">
      Legacy window start (kept in sync with the first schedule window)
    </ResponseField>

    <ResponseField name="allowed_hours_end_time" type="string">
      Legacy window end
    </ResponseField>

    <ResponseField name="allowed_days" type="array">
      Weekdays when sending/calling is allowed
    </ResponseField>

    <ResponseField name="max_retries" type="integer">
      Max retries per lead
    </ResponseField>

    <ResponseField name="retry_interval" type="integer">
      Minutes between retries
    </ResponseField>

    <ResponseField name="retry_on_voicemail" type="boolean">
      Call campaigns: retry on voicemail
    </ResponseField>

    <ResponseField name="retry_on_goal_incomplete" type="boolean">
      Call campaigns: retry until goal variable is true
    </ResponseField>

    <ResponseField name="goal_completion_variable" type="string">
      Boolean post-call variable name, or `null`
    </ResponseField>

    <ResponseField name="mark_complete_when_no_leads" type="boolean">
      Auto-complete when no work remains
    </ResponseField>

    <ResponseField name="phone_number_ids" type="array">
      Outbound from-number IDs (call campaigns)
    </ResponseField>

    <ResponseField name="whatsapp_sender_id" type="integer">
      WhatsApp sender ID, or `null`
    </ResponseField>

    <ResponseField name="whatsapp_template_id" type="integer">
      WhatsApp template ID, or `null`
    </ResponseField>

    <ResponseField name="sms_from_phone_number_id" type="integer">
      SMS from-number ID, or `null`
    </ResponseField>

    <ResponseField name="sms_body" type="string">
      SMS body, or `null`
    </ResponseField>

    <ResponseField name="text_variable_mapping" type="object">
      WhatsApp template placeholder → lead variable map, or `null`
    </ResponseField>

    <ResponseField name="fallback_channel" type="string">
      Call→text fallback channel (`whatsapp` / `sms`), or `null`
    </ResponseField>

    <ResponseField name="fallback_whatsapp_sender_id" type="integer">
      Fallback WhatsApp sender, or `null`
    </ResponseField>

    <ResponseField name="fallback_whatsapp_template_id" type="integer">
      Fallback WhatsApp template, or `null`
    </ResponseField>

    <ResponseField name="fallback_sms_from_phone_number_id" type="integer">
      Fallback SMS from-number, or `null`
    </ResponseField>

    <ResponseField name="fallback_sms_body" type="string">
      Fallback SMS body, or `null`
    </ResponseField>

    <ResponseField name="fallback_variable_mapping" type="object">
      Fallback WhatsApp variable map, or `null`
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Created timestamp in your account timezone
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Updated timestamp in your account timezone
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 Response theme={null}
  [
    {
      "id": 1,
      "name": "New Customer Acquisition Q1 2026",
      "channel": "call",
      "status": "in-progress",
      "assistant_id": 42,
      "timezone": "Europe/Berlin",
      "max_calls_in_parallel": 5,
      "messages_per_minute": null,
      "schedule_windows": [
        { "start": "09:00", "end": "18:00" }
      ],
      "scheduled_start_at": null,
      "allowed_hours_start_time": "09:00",
      "allowed_hours_end_time": "18:00",
      "allowed_days": ["monday", "tuesday", "wednesday", "thursday", "friday"],
      "max_retries": 3,
      "retry_interval": 60,
      "retry_on_voicemail": true,
      "retry_on_goal_incomplete": false,
      "goal_completion_variable": null,
      "mark_complete_when_no_leads": true,
      "phone_number_ids": [101, 102],
      "whatsapp_sender_id": null,
      "whatsapp_template_id": null,
      "sms_from_phone_number_id": null,
      "sms_body": null,
      "text_variable_mapping": null,
      "fallback_channel": "whatsapp",
      "fallback_whatsapp_sender_id": 7,
      "fallback_whatsapp_template_id": 15,
      "fallback_sms_from_phone_number_id": null,
      "fallback_sms_body": null,
      "fallback_variable_mapping": { "1": "first_name" },
      "created_at": "2026-01-10T08:00:00Z",
      "updated_at": "2026-01-15T14:30:00Z"
    }
  ]
  ```
</ResponseExample>

<Tip>
  Related pages: [Introduction](/api-v1/introduction) and [Authentication Guide](/api-v1/authentication), and [API Integration Examples](/api-v1/introduction).
</Tip>