Campaigns

Update a draft campaign

POST /campaigns/{CampaignID}/update.{Format}

Updates the details of an existing draft campaign in your account. Non-draft campaigns cannot be updated. If you are updating a regular campaign, you can ignore the A/B split campaign parameters.

Request

Parameter	In	Type	Required	Description
Accept	header	string	true	Determines the expected format and data type to retrieve the response data.Value: application/json
CampaignID	path	string	true	The ID of the campaign that you want to update.
Format	path	string	true	The supported file format for getting a response.Possible values: json and xml
apikey	query	string	true	The API key of your account.
Name	body	string	true	The name of the campaign.
Subject	body	string	false	The subject line of the campaign.
SenderEmail	body	string	false	The email address of the campaign sender.
ReplyToEmail	body	string	false	The email address selected to receive replies from the campaign. This must be one of your campaign senders. If not specified, the SenderEmail is assumed.
ConfirmationToEmail	body	string	false	The email address used to send a confirmation message when the campaign has been successfully sent. This can be any valid email address. If not specified, the SenderEmail is assumed.
HTMLContent	body	string	false	The full HTML content of the campaign. You can use this instead of WebLocation. Omitting this when updating a draft will remove the HTML content.
WebLocation	body	string	false	The URL used to retrieve the HTML content of the campaign. Sitecore Send automatically moves all CSS inline.
MailingLists	body	array	false	A list of email lists in your account that is used to send the campaign.
SegmentID	body	string	false	The ID of a segment in the selected email list. If not specified, the campaign is sent to all active subscribers of the email list.
IsAB	body	Boolean	false	A flag that defines if a campaign is an A/B split campaign. If true, you must fill out A/B split campaign parameters.
TrackInGoogleAnalytics	body	Boolean	false	Specifies if tracking is enabled for the campaign. You must have Google Analytics configured on your site to use this feature.

A/B split campaign parameters

Use these parameters when updating an A/B split campaign. If you specify any of the parameters below when updating a regular campaign, they are ignored in the request.

Name	In	Type	Required	Description
ABCampaignType	body	string	true	Specify the type of test to be performed in the AB split campaign to determine the winning version - test two different versions of the subject line.Content - test two different versions of the campaign content.Sender - test two different versions of the campaign sender.
SubjectB	body	string	false	If testing A/B split campaigns with two subject line versions, this is the second subject version of the subject.
WebLocationB	body	string	false	If testing A/B split campaigns with two HTML content versions, this is the web location of the second HTML content version.
SenderEmailB	body	string	false	If testing A/B split campaigns with two sender versions, this is the email address of the second campaign sender. This must be one of the senders defined in your account.
HoursToTest	body	integer	false	Specify how long the test runs, before determining the winning campaign version to be sent to the rest of the recipients.This must be an integer between 1 and 24.
ListPercentage	body	integer	false	Specifies a portion of the target recipients to get the test campaign versions. For example, if you specify 10, then 10% of your recipients receive campaign A and another 10% receive the campaign B version.This must be an integer between 5 and 40.
ABWinnerSelectionType	body	string	false	Specifies the method to determine the winning version for the test. If not set, OpenRate is assumed.OpenRate -determine the winner based on the version that achieved more opens.TotalUniqueClicks - determine the winner based on the version that achieved more unique link clicks.

POST https://{hostname}/v3/campaigns/{CampaignID}/update.{Format}?apikey=

Request body:
{
  "Name": "Test campaign",
  "Subject": "Some subject",
  "SenderEmail": "[email protected]",
  "ReplyToEmail": "[email protected]",
  "ConfirmationToEmail": "[email protected]",
  "WebLocation": "http://www.mysite.gr/newsletter/index",
  "MailingLists": \[
    {
      "MailingListID": "adaf2fe1-55db-42dc-aaf8-56d8f502138d",
      "SegmentID": "10166"
    },
    {
      "MailingListID": "dce99b7a-2619-4805-aaeb-7fecdcb3c71b"
    }
  \],
  "IsAB": "true",
  "ABCampaignType": "Content",
  "WebLocationB": "http://www.mysite.gr/newsletter/index",
  "HoursToTest": "2",
  "ListPercentage": "20",
  "ABWinnerSelectionType": "OpenRate"
}

curl --include \\
     --request POST \\
     --header "Content-Type: application/json" \\
     --header "Accept: application/json" \\
     --data-raw '{
    "Name": "Test campaign",
    "Subject": "Some subject",
    "SenderEmail": "[email protected]",
    "ReplyToEmail": "[email protected]",
    "ConfirmationToEmail": "[email protected]",
    "WebLocation": "http://www.mysite.gr/newsletter/index",
    "MailingLists": \[
        {
            "MailingListID": "adaf2fe1-55db-42dc-aaf8-56d8f502138d",
            "SegmentID": "10166"
        },
        {
            "MailingListID": "dce99b7a-2619-4805-aaeb-7fecdcb3c71b"
        }
    \],
    "IsAB": "true",
    "ABCampaignType": "Content",
    "WebLocationB": "http://www.mysite.gr/newsletter/index",
    "HoursToTest": "2",
    "ListPercentage": "20",
    "ABWinnerSelectionType": "OpenRate"
}' \\
'https://{hostname}/v3/campaigns/{CampaignID}/update.{Format}?apikey='

Response

Status	Description	Headers	Schema
200 OK	The request is successful.	Content-Type /jsonAccept /json	N/A

{
  "Code": 0,
  "Error": null,
  "Context": null
}

Code - the response code. This is 0 if successful.
Error - the response error message. This is null if successful.
Context - this is null if successful.

If you have suggestions for improving this article, let us know!