PUT Update Messaging Campaign

PUT

/messaging/campaigns/{id}

Update a campaign's title, message_content and (when non-empty) settings. Both title and message_content are required on every call. settings replaces the stored object wholesale, so send the complete settings, including template_id / template_variables for WhatsApp. Other fields (channel, sender_number, scheduled_at, status) are ignored. next_step is stored as the wizard step to reopen at. Does not check the campaign status. Fires fluent_crm/whatsapp_campaign_updated or fluent_crm/sms_campaign_updated.

Channel: this route does not take a channel; the channel is the one stored on the campaign (sms or whatsapp) and the matching channel hooks are fired. PRO — requires the FluentCampaign Pro Messaging module with at least one channel (SMS or WhatsApp) active.

Required capability: fcrm_read_emails or fcrm_manage_emails — which one applies depends on the action being performed.

Enforced by MessagePolicy::verifyRequest(), the policy default for this route group.

Requires: FluentCampaign Pro with the Messaging module enabled. While no messaging channel (SMS or WhatsApp) is switched on the route is not registered at all and returns a 404.

Authorizations

ApplicationPasswords

WordPress Application Passwords — use Basic auth with your WordPress username and an application password in the format: username:application_password

Type

API Key (header: Authorization)

Parameters

Path Parameters

id*

Campaign id.

Type

integer

Required

Request Body

application/json

{

"title": "string",

"message_content": "string",

"settings": {

"sending_filter": "string",

"sending_type": "string",

"is_transactional": "string",

"subscribers": [

{

"list": "string",

"tag": "string"

}

],

"excludedSubscribers": [

{

"list": "string",

"tag": "string"

}

],

"dynamic_segment": {

"id": "string",

"slug": "string"

},

"advanced_filters": [

[

]

],

"template_id": 0,

"template_variables": {

"additionalProperties": "string"

},

"one_time_audience": {

"active_batch_id": "string",

"accepted_count": 0,

"default_country": "string",

"consent_user_id": 0,

"consent_channel": "string",

"consent_confirmed": "string"

}

},

"next_step": 0

}

Responses

Campaign updated.

Content-Type

application/json

{

"campaign": {

"id": 0,

"parent_id": 0,

"type": "string",

"title": "string",

"slug": "string",

"status": "string",

"message_content": "string",

"sender_number": "string",

"recipients_count": 0,

"sent_count": 0,

"failed_count": 0,

"delay": 0,

"scheduled_at": "string",

"settings": {

"sending_filter": "string",

"sending_type": "string",

"is_transactional": "string",

"subscribers": [

{

"list": "string",

"tag": "string"

}

],

"excludedSubscribers": [

{

"list": "string",

"tag": "string"

}

],

"dynamic_segment": {

"id": "string",

"slug": "string"

},

"advanced_filters": [

[

]

],

"template_id": 0,

"template_variables": {

"additionalProperties": "string"

},

"one_time_audience": {

"active_batch_id": "string",

"accepted_count": 0,

"default_country": "string",

"consent_user_id": 0,

"consent_channel": "string",

"consent_confirmed": "string"

}

},

"channel": "string",

"created_by": 0,

"created_at": "string",

"updated_at": "string",

"next_step": "string",

"labels": [

{

"id": 0,

"slug": "string",

"title": "string",

"color": "string"

}

],

"server_time": "string"

},

"message": "string"

}

PUT

/messaging/campaigns/{id}

Playground

Authorization

ApplicationPasswords

Variables

Key

Value

id*

Body

Samples

Powered by VitePress OpenAPI