PUT /emailCampaigns/{campaignId}

Servers

Path parameters

Name Type Required Description
campaignId Integer Yes

Id of the campaign

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
mirrorActive Boolean No

Status of mirror links in campaign. mirrorActive = false means mirror links are deactivated, & mirrorActive = true means mirror links are activated, in the campaign

htmlContent String No

Body of the message (HTML version). REQUIRED if htmlUrl is empty

replyTo String No

Email on which campaign recipients will be able to reply to

scheduledAt String No

UTC date-time on which the campaign has to run (YYYY-MM-DDTHH:mm:ss.SSSZ). Prefer to pass your timezone in date-time format for accurate result. If sendAtBestTime is set to true, your campaign will be sent according to the date passed (ignoring the time part).

subject String No

Subject of the campaign

tag String No

Tag of the campaign

footer String No

Footer of the email campaign

params Object No

Pass the set of attributes to customize the type 'classic' campaign. For example, {"FNAME":"Joe", "LNAME":"Doe"}. The 'params' field will get updated, only if the campaign is in New Template Language, else ignored. The New Template Language is dependent on the values of 'subject', 'htmlContent/htmlUrl', 'sender.name' & 'toField'

sendAtBestTime Boolean No

Set this to true if you want to send your campaign at best time. Note:- if true, warmup ip will be disabled.

htmlUrl String No

Url which contents the body of the email message. REQUIRED if htmlContent is empty

winnerDelay Integer No

Choose the duration of the test in hours. Maximum is 7 days, pass 24*7 = 168 hours. The winning version will be sent at the end of the test. Considered if 'splitRule' >= 1 and < 50. If splitRule = 50, 'winnerDelay' is ignored if passed or alreday exist in record

initialQuota Integer No

Set an initial quota greater than 1 for warming up your ip. We recommend you set a value of 3000.

utmCampaign String No

Customize the utm_campaign value. If this field is empty, the campaign name will be used. Only alphanumeric characters and spaces are allowed

recipients Object No

List ids to include/exclude from campaign

recipients.listIds[] Array No

Lists Ids to send the campaign to. REQUIRED if already not present in campaign and scheduledAt is not empty

recipients.exclusionListIds[] Array No

List ids which have to be excluded from a campaign

winnerCriteria String No

Choose the metrics that will determinate the winning version. Considered if 'splitRule' >= 1 and < 50. If splitRule = 50, 'winnerCriteria' is ignored if passed or alreday exist in record

Valid values:

  • "open"
  • "click"
recurring Boolean No

FOR TRIGGER ONLY ! Type of trigger campaign.recurring = false means contact can receive the same Trigger campaign only once, & recurring = true means contact can receive the same Trigger campaign several times

Default value: false

sender Object No

Sender details including id or email and name (optional). Only one of either Sender's email or Sender's ID shall be passed in one request at a time. For example {"name":"xyz", "email":"example@abc.com"} , {"name":"xyz", "id":123}

sender.id Integer No

Select the sender for the campaign on the basis of sender id. In order to select a sender with specific pool of IP’s, dedicated ip users shall pass id (instead of email).

sender.name String No

Sender Name from which the campaign emails are sent

sender.email String No

Sender email from which the campaign emails are sent

subjectA String No

Subject A of the campaign. Considered if abTesting = true. subjectA & subjectB should have unique value

subjectB String No

Subject B of the campaign. Considered if abTesting = true. subjectA & subjectB should have unique value

attachmentUrl String No

Absolute url of the attachment (no local file). Extension allowed: xlsx, xls, ods, docx, docm, doc, csv, pdf, txt, gif, jpg, jpeg, png, tif, tiff, rtf, bmp, cgm, css, shtml, html, htm, zip, xml, ppt, pptx, tar, ez, ics, mobi, msg, pub and eps

inlineImageActivation Boolean No

Status of inline image. inlineImageActivation = false means image can’t be embedded, & inlineImageActivation = true means image can be embedded, in the email. You cannot send a campaign of more than 4MB with images embedded in the email. Campaigns with the images embedded in the email must be sent to less than 5000 contacts.

Default value: false

splitRule Integer No

Add the size of your test groups. Considered if abTesting = true. We'll send version A and B to a random sample of recipients, and then the winning version to everyone else

name String No

Name of the campaign

abTesting Boolean No

Status of A/B Test. abTesting = false means it is disabled, & abTesting = true means it is enabled. 'subjectA', 'subjectB', 'splitRule', 'winnerCriteria' & 'winnerDelay' will be considered if abTesting is set to true. 'subject' if passed is ignored. Can be set to true only if 'sendAtBestTime' is 'false'. You will be able to set up two subject lines for your campaign and send them to a random sample of your total recipients. Half of the test group will receive version A, and the other half will receive version B

Default value: false

header String No

Header of the email campaign

ipWarmupEnable Boolean No

Available for dedicated ip clients. Set this to true if you wish to warm up your ip.

Default value: false

toField String No

To personalize the «To» Field. If you want to include the first name and last name of your recipient, add {FNAME} {LNAME}. These contact attributes must already exist in your SendinBlue account. If input parameter 'params' used please use {{contact.FNAME}} {{contact.LNAME}} for personalization

increaseRate Integer No

Set a percentage increase rate for warming up your ip. We recommend you set the increase rate to 30% per day. If you want to send the same number of emails every day, set the daily increase value to 0%.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.