Skip to main content
POST
/
campaigns
/
status
curl --request POST \
  --url https://api-{dc}.moengage.com/core-services/v1/campaigns/status \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --header 'MOE-APPKEY: <moe-appkey>' \
  --data '
{
  "request_id": "status_change_pause",
  "action": "PAUSE",
  "campaign_ids": [
    "camp_periodic_123"
  ]
}
'
{
  "error": {
    "code": "400 Bad Request",
    "message": "request_id key is mandatory field",
    "target": "request_id",
    "details": [
      {
        "target": "request_id",
        "message": "request_id key is mandatory field"
      }
    ],
    "request_id": "11"
  }
}
Currently, you can use this API to change the status of Email and Push campaigns. You can update the following statuses of the campaigns:
  • Stop a scheduled One-time campaign (Email and Push)
  • Pause and resume a running Periodic or Event-triggered Email campaign.
  • Pause and resume the following running Push campaigns:
    • Periodic
    • Event-triggered
    • Device-triggered
    • Location-triggered

​
Rate Limits

Rate Limit NameRate Limit
change campaign status per secondThe total number of change campaign status requests per second per client is 10.
change campaign status per minuteThe total number of change campaign status requests per minute per client allowed is 100.
change campaign statusper hourThe total number of change campaign status requests per hour per client allowed is 6000.
Notes
  • Breaching the limits will reject the request.
  • Per hour and per day limits will consider the calculation based on the last hour and last 24 hrs respectively.

Authorizations

​
Authorization
string
header
required

Authentication is done via Basic Auth. This requires a base64-encoded string of your credentials in the format 'username:password'.

  • Username: Use your MoEngage workspace ID (also known as the App ID). You can find it in the MoEngage dashboard at Settings > Account > APIs > Workspace ID (earlier app id).
  • Password: Use your API Key, which you can find within the Campaign report/Business events/Custom templates/Catalog API/Inform Report tile.

For more information on authentication and getting your credentials, refer here.

Headers

​
MOE-APPKEY
string
required

This is the Workspace ID of your MoEngage account that must be passed with the request. You can find it in the MoEngage dashboard at Settings > Account > APIs > Workspace ID (earlier app id).

Body

application/json

Send campaign status change request with action and campaign IDs.

You can request to change the status of one or more campaigns.

​
request_id
string
required

A unique identifier for this status change request.

Example:

"status_change_12345"

​
action
enum<string>
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.
  • RESUME: Resume a paused Periodic or Event-triggered campaign.
Available options:
STOP,
PAUSE,
RESUME
​
campaign_ids
string[]
required

Array of campaign IDs whose status you want to change.

Maximum: 10 campaign IDs per request

Required array length: 1 - 10 elements
Example:
["camp_abc123", "camp_def456"]

Response

Campaign status changed successfully. No content returned.

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