---
title: "Change Campaign Status"
method: POST
path: "/campaigns/status"
tags: ["Update Campaigns"]
---

# Change Campaign Status

`POST /campaigns/status`

## Request

- Base URL: `https://api-01.moengage.com/core-services/v1`
- URL: `https://api-01.moengage.com/core-services/v1/campaigns/status`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/moengage/apis/moengage-campaigns-api/docs/campaigns/status/post.ts> (a function with typed inputs; its response is checked against the schema)

This API updates the status of campaigns to stop, pause, or resume them. You can only change the status of campaigns created via the [Create Campaign API](https://www.moengage.com/docs/api/create-campaigns/create-campaign) (not dashboard-created campaigns).

## Headers

- `MOE-APPKEY` string, required

## Request body

- CampaignStatusChangeRequest: You can request to change the status of one or more campaigns.
  - `request_id` string, required: A unique identifier for this status change request.
  - `action` 'STOP' | 'PAUSE' | 'RESUME', required: The action to perform on the campaign(s). - **STOP**: Stop a scheduled One-time campaign (cannot be used for Periodic campaigns). After a One-time campaign moves to Active state, it cannot be stopped. - **PAUSE**: Pause a running Periodic or Event-triggered campaign. `PAUSE` is not supported for `BUSINESS_EVENT_TRIGGERED`, `DEVICE_TRIGGERED`, or `LOCATION_TRIGGERED` campaigns. - **RESUME**: Resume a paused Periodic or Event-triggered campaign. `RESUME` is not supported for `BUSINESS_EVENT_TRIGGERED`, `DEVICE_TRIGGERED`, or `LOCATION_TRIGGERED` campaigns.
  - `campaign_ids` string[], required: Array of campaign IDs whose status you want to change. **Maximum:** 10 campaign IDs per request

## Response `200`

Campaign status changed successfully. No content returned.

For a successful 200 response, the API does not return any content.

## Other responses

- `400`: Bad Request - Missing or invalid parameters
- `401`: Authentication Failure - Invalid or missing authentication credentials
- `500`: Internal Server Error - Unexpected system error

---

[API](https://skmtc.dev/moengage/apis/moengage-campaigns-api.md) - [All operations](https://skmtc.dev/moengage/apis/moengage-campaigns-api/llms.txt) - [OpenAPI document](https://skmtc.dev/moengage/apis/moengage-campaigns-api/revisions/7fc8a931584f?raw)
