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

# Kampagnen-Status aktualisieren

> Anruf-, WhatsApp- oder SMS-Kampagne per API starten oder stoppen. Beim Start werden Channel-Config, Schedule und Guthaben geprüft.

<Warning>
  **Famulor 1.0 API (Legacy).** Diese Seite gilt nur für Famulor 1.0 (`app.famulor.de`) und bleibt aus Kompatibilitätsgründen erhalten. Für die aktuelle Plattform nutze die [Famulor 2.0 API-Referenz](/de/api-reference/introduction).
</Warning>

Startet oder stoppt eine Kampagne, die dir gehört. Beim Start werden Channel-Config (Assistent / WhatsApp-Template / SMS-Nummer), Schedule und Guthaben geprüft. Deaktivierte Channels (z. B. SMS, wenn vorübergehend nicht verfügbar) können nicht gestartet werden.

### Anfrage-Body

<ParamField body="campaign_id" type="integer" required>
  Die ID der zu aktualisierenden Kampagne
</ParamField>

<ParamField body="action" type="string" required>
  `start` oder `stop`
</ParamField>

### Antwort

<ResponseField name="message" type="string" default="Campaign started successfully.">
  Menschenlesbares Ergebnis
</ResponseField>

<ResponseField name="success" type="boolean" default="true">
  Ob die Operation erfolgreich war
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="data-Eigenschaften">
    <ResponseField name="campaign_id" type="integer">
      Kampagnen-ID
    </ResponseField>

    <ResponseField name="status" type="string" default="in-progress">
      Neuer Status (z. B. `in-progress`, `paused`)
    </ResponseField>

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

<ResponseExample>
  ```json 200 Kampagne gestartet theme={null}
  {
    "message": "Campaign started successfully.",
    "success": true,
    "data": {
      "campaign_id": 2324,
      "status": "in-progress",
      "channel": "call"
    }
  }
  ```

  ```json 200 Kampagne gestoppt theme={null}
  {
    "message": "Campaign stopped successfully.",
    "success": true,
    "data": {
      "campaign_id": 2324,
      "status": "paused",
      "channel": "whatsapp"
    }
  }
  ```

  ```json 400 Ungültige Aktion theme={null}
  {
    "message": "Invalid action. Must be either 'start' or 'stop'.",
    "success": false
  }
  ```

  ```json 404 Kampagne nicht gefunden theme={null}
  {
    "message": "Campaign not found.",
    "success": false
  }
  ```

  ```json 400 Unzureichendes Guthaben theme={null}
  {
    "message": "Insufficient balance to start the campaign. Please top up your account.",
    "success": false,
    "data": {
      "campaign_id": 2324,
      "status": "draft",
      "channel": "call"
    }
  }
  ```
</ResponseExample>

<Tip>
  Verwandte Seiten: [Einführung](/de/api-v1/introduction) und [Authentifizierungs-Leitfaden](/de/api-v1/authentication) sowie [API-Integrationsbeispiele](/de/api-v1/introduction).
</Tip>