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

# Update campaign status

> Start or stop a call, WhatsApp, or SMS campaign via API. Starting validates channel config, schedule, and balance.

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

Start or stop a campaign you own. Starting validates channel config (assistant / WhatsApp template / SMS number), schedule, and balance. Disabled channels (for example SMS when temporarily unavailable) cannot be started.

### Request body

<ParamField body="campaign_id" type="integer" required>
  The ID of the campaign to update
</ParamField>

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

### Response

<ResponseField name="message" type="string" default="Campaign started successfully.">
  Human-readable outcome
</ResponseField>

<ResponseField name="success" type="boolean" default="true">
  Whether the operation succeeded
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="data properties">
    <ResponseField name="campaign_id" type="integer">
      Campaign ID
    </ResponseField>

    <ResponseField name="status" type="string" default="in-progress">
      New status (e.g. `in-progress`, `paused`)
    </ResponseField>

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

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

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

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

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

  ```json 400 Insufficient balance 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>
  Related pages: [Introduction](/api-v1/introduction) and [Authentication Guide](/api-v1/authentication), and [API Integration Examples](/api-v1/introduction).
</Tip>