Replace Campaign

PUT

https://api.sudonum.com.com/v2/campaign/campaigns/{uuid}/

Replaces every writable field on a campaign. Fields you omit keep their current value; they are not cleared.

Required fields are campaign_status and name.

Request

Path Params

Body Params

application/json

Required

Example

{
    "name": "Summer promo",
    "campaign_status": "DRAFT",
    "category": "PROMOTIONS",
    "message_data": {
        "template": {
            "name": "summer_promo_v1"
        },
        "template_header_url": "https://example.com/media/header.jpg",
        "whatsapp_id": "27820001234"
    },
    "campaign_list": "9f8e7d6c-5b4a-4321-9876-0fedcba98765"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://api.sudonum.com.com/v2/campaign/campaigns/123e4567-e89b-12d3-a456-426614174000/' \
--header 'Content-Type: application/json' \
--data '{
    "name": "Summer promo",
    "campaign_status": "DRAFT",
    "category": "PROMOTIONS",
    "message_data": {
        "template": {
            "name": "summer_promo_v1"
        },
        "template_header_url": "https://example.com/media/header.jpg",
        "whatsapp_id": "27820001234"
    },
    "campaign_list": "9f8e7d6c-5b4a-4321-9876-0fedcba98765"
}'

Responses

🟢200

application/json

Bodyapplication/json

Example

{
    "uuid": "b9d90e87-9b6c-465a-be8f-6ac5d30c1eb4",
    "name": "Summer promo",
    "message_data": {
        "template": {
            "name": "summer_promo_v1"
        },
        "whatsapp_id": "27820001234",
        "template_header_url": "https://example.com/media/header.jpg"
    },
    "campaign_status": "DRAFT",
    "scheduled_at": null,
    "channel_type": "WHATSAPP",
    "category": "PROMOTIONS",
    "campaign_list": "9f8e7d6c-5b4a-4321-9876-0fedcba98765",
    "campaign_log": {
        "uuid": "5f8b60a2-fdfa-4d94-b540-a7a2b6b3b771",
        "contact_count": 250,
        "contact_count_subscribed": 248,
        "contact_count_unsubscribed": 2,
        "messages_sent_count": 0,
        "messages_delivered_count": 0,
        "messages_failed_count": 0,
        "created": "2026-07-20T09:00:00Z",
        "modified": "2026-07-20T09:00:00Z"
    },
    "campaign_list_name": "Summer 2026 subscribers",
    "campaign_list_status": {},
    "created": "2026-07-20T09:00:00Z",
    "modified": "2026-07-20T09:00:00Z"
}

Modified at 2026-08-31 07:42:46

Single Campaign

Update Campaign