Cancel Campaign

Cancel a Scheduled, Queued, or Sending campaign. Messages that have already been handed off for delivery cannot be recalled — cancellation only prevents messages that have not yet been dispatched.

Endpoint

POST /sms/campaigns/:id/cancel

Returns: 200 OK

Prerequisites

Cancellation Limits

Cancellation only stops messages that have not yet been handed off for delivery. Recipients who already received the message will not be affected. Campaigns in Sent, Failed, or Cancelled status cannot be cancelled again.

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	The campaign ID.

Headers

Header	Value	Required
Authorization	Bearer <your-api-key>	Yes

Response

{
  "message": "Campaign cancelled"
}

---

Examples

cURL

curl -X POST "https://api.arsel.sa/v1/sms/campaigns/0192a1b2-c3d4-7e5f-9000-abcdef123456/cancel" \
  -H "Authorization: Bearer be_your_api_key"

JavaScript

const campaignId = "0192a1b2-c3d4-7e5f-9000-abcdef123456";

const response = await fetch(
  `https://api.arsel.sa/v1/sms/campaigns/${campaignId}/cancel`,
  {
    method: "POST",
    headers: { Authorization: "Bearer be_your_api_key" },
  }
);

const result = await response.json();
console.log(result.message); // "Campaign cancelled"

Python

import requests

campaign_id = "0192a1b2-c3d4-7e5f-9000-abcdef123456"

response = requests.post(
    f"https://api.arsel.sa/v1/sms/campaigns/{campaign_id}/cancel",
    headers={"Authorization": "Bearer be_your_api_key"},
)

result = response.json()
print(result["message"])  # "Campaign cancelled"

C#

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer be_your_api_key");

var campaignId = "0192a1b2-c3d4-7e5f-9000-abcdef123456";
var response = await client.PostAsync(
    $"https://api.arsel.sa/v1/sms/campaigns/{campaignId}/cancel",
    null
);
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);

PHP

<?php
$campaignId = "0192a1b2-c3d4-7e5f-9000-abcdef123456";
$ch = curl_init("https://api.arsel.sa/v1/sms/campaigns/{$campaignId}/cancel");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer be_your_api_key"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, "");
$response = curl_exec($ch);
echo $response;
curl_close($ch);

---

Error Responses

400 Bad Request

{
  "status_code": 400,
  "name": "bad_request",
  "message": "Campaign cannot be cancelled in its current status"
}

401 Unauthorized

{
  "status_code": 401,
  "name": "unauthorized",
  "message": "Invalid or missing API key"
}

404 Not Found

{
  "status_code": 404,
  "name": "not_found",
  "message": "Campaign not found"
}