Initiate Campaign Rerun

Initiates a new campaign run against a different customer group in a single atomic operation. This endpoint combines segment preview, run record creation, campaign state update, previous-run message archival, and async processing job queuing — all in one call.

Prerequisites:

The campaign must have a status of Published

All messages in the current run must be in Published status before a rerun can be initiated

The endpoint automatically archives all messages from the previous run. Orphaned segment messages (those no longer relevant to the new customer group) are also archived during async processing.
Enables external integrations to fully automate the campaign refresh cycle — updating the customer group and triggering message generation without any manual steps in the platform.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --request POST 'https://client-api.nudgescribe.com/v1/campaign/rerun/initiate' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "campaign_id": "your-campaign-uuid", "new_customer_group_id": "your-new-customer-group-uuid" }'

{ "success": true, "rerun_id": "your-campaign-rerun-uuid", "run_number": 3, "campaign_status": "Ready for review", "job_uid": "your-job-uuid", "archived_count": 10, "comparison": { "matched_count": 8, "new_count": 4, "orphaned_count": 2 }, "message": "Campaign rerun initiated successfully" }

Request

Responses