Update Campaign

Update one or more fields of an existing SMS campaign. This is a partial update — only the fields you include in the request body are changed. Omitted fields keep their current values.

Endpoint

PATCH /sms/campaigns/:id

Returns: 200 OK

Prerequisites

Status Restriction

Only campaigns in Draft or Scheduled status can be updated. Campaigns that are Queued, Sending, Sent, Paused, Failed, or Cancelled cannot be modified. Attempting to update a campaign in a non-editable status returns 400 bad_request.

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	The campaign ID.

Headers

Header	Value	Required
Authorization	Bearer <your-api-key>	Yes
Content-Type	application/json	Yes

Body Parameters

Parameter	Type	Required	Description
name	string	No	Internal name for the campaign. Max 100 characters.
description	string	No	Optional description for internal reference. Max 500 characters.
content	string	No	SMS message body. Max 3,200 characters. Supports {{variables}} from contact properties.
from	string	No	Registered SMS sender name, registered for marketing. Country-specific approval required; see List Senders.
list_ids	string[]	No	IDs of contact lists whose contacts should receive the campaign. Replaces the existing list.
tag_ids	string[]	No	IDs of tags whose tagged contacts should receive the campaign. Replaces the existing list.
segment_ids	string[]	No	IDs of segments whose matching contacts should receive the campaign; see List Segments. Replaces the existing list.

Response

{
  "id": "0192a1b2-c3d4-7e5f-9000-abcdef123456"
}

Response Fields

Field	Type	Description
id	string	Unique campaign ID. Use this with GET /sms/campaigns/:id to fetch the full record, or with POST /sms/campaigns/:id/send to send or schedule.

---

Examples

cURL

curl -X PATCH "https://api.arsel.sa/v1/sms/campaigns/0192a1b2-c3d4-7e5f-9000-abcdef123456" \
  -H "Authorization: Bearer $ARSEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Last chance — 50% off ends tonight! Shop: {{link}}"
  }'

JavaScript

const response = await fetch("https://api.arsel.sa/v1/sms/campaigns/0192a1b2-c3d4-7e5f-9000-abcdef123456", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.ARSEL_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    content: "Last chance — 50% off ends tonight! Shop: {{link}}",
  }),
});

const data = await response.json();
if (!response.ok) {
  throw new Error(`${data.name}: ${data.message}`);
}

console.log(data);

Python

import os

import requests

response = requests.patch(
    "https://api.arsel.sa/v1/sms/campaigns/0192a1b2-c3d4-7e5f-9000-abcdef123456",
    headers={"Authorization": f"Bearer {os.environ['ARSEL_API_KEY']}"},
    json={
        "content": "Last chance — 50% off ends tonight! Shop: {{link}}",
    },
)
response.raise_for_status()

print(response.json())

C#

using System.Net.Http.Headers;
using System.Text;

var client = new HttpClient(); // share one instance across requests
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("ARSEL_API_KEY"));

var request = new HttpRequestMessage(HttpMethod.Patch, "https://api.arsel.sa/v1/sms/campaigns/0192a1b2-c3d4-7e5f-9000-abcdef123456")
{
    Content = new StringContent(
        """
        {
          "content": "Last chance — 50% off ends tonight! Shop: {{link}}"
        }
        """,
        Encoding.UTF8,
        "application/json"),
};

var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
if (!response.IsSuccessStatusCode)
    throw new HttpRequestException($"{(int)response.StatusCode}: {body}");

Console.WriteLine(body);

PHP

<?php
$ch = curl_init("https://api.arsel.sa/v1/sms/campaigns/0192a1b2-c3d4-7e5f-9000-abcdef123456");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "PATCH",
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("ARSEL_API_KEY"),
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => json_encode([
        "content" => "Last chance — 50% off ends tonight! Shop: {{link}}",
    ]),
]);

$data = json_decode(curl_exec($ch), true);
if (curl_getinfo($ch, CURLINFO_HTTP_CODE) >= 400) {
    throw new Exception("{$data['name']}: {$data['message']}");
}

print_r($data);

---

Error Responses

400 Bad Request

{
  "status_code": 400,
  "name": "bad_request",
  "message": "Cannot edit a campaign that is sending or sent"
}

422 Validation Error

{
  "status_code": 422,
  "name": "validation_error",
  "message": "name must not exceed 100 characters"
}

404 Not Found

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

401 Unauthorized

{
  "status_code": 401,
  "name": "unauthorized",
  "message": "Invalid API Key"
}