PUT /emailCampaigns/{campaignId}
Update an email campaignServers
- https://api.brevo.com/v3
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). If the campaign is designed using Drag & Drop editor via HTML content, then the design page will not have Drag & Drop editor access for that campaign. REQUIRED if htmlUrl is empty |
previewText |
String | No |
Preview text or preheader of the email campaign |
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 |
footer |
String | No |
Footer of the email campaign |
tag |
String | No |
Tag of the campaign |
params |
Object | No |
Pass the set of attributes to customize the type classic campaign. For example: {"FNAME":"Joe", "LNAME":"Doe"}. Only available if type is classic. It's considered only if campaign is in New Template Language format. 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. Mandatory if splitRule >= 1 and < 50. If splitRule = 50, |
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 |
updateFormId |
String | No |
Mandatory if templateId is used containing the {{ update_profile }} tag. Enter an update profile form id. The form id is a 24 digit alphanumeric id that can be found in the URL when editing the form. |
recipients |
Object | No |
Segment ids and List ids to include/exclude from campaign |
recipients.segmentIds[] |
Array | No |
Mandatory if listIds are not used. Campaign should only be updated with segmentIds if segmentIds were used to create it. Segment ids to send the campaign to. |
recipients.listIds[] |
Array | No |
Lists Ids to send the campaign to. Campaign should only be updated with listIds if listIds were used to create it. REQUIRED if already not present in campaign and scheduledAt is not empty |
recipients.exclusionSegmentIds[] |
Array | No |
Segment ids which have to be excluded from a campaign. |
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. Mandatory if splitRule >= 1 and < 50. If splitRule = 50, Valid values:
|
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 |
unsubscriptionPageId |
String | No |
Enter an unsubscription page id. The page id is a 24 digit alphanumeric id that can be found in the URL when editing the page. |
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.email |
String | No |
Sender email from which the campaign emails are sent |
sender.name |
String | No |
Sender Name from which the campaign emails are sent |
subjectA |
String | No |
Subject A of the campaign. Mandatory if abTesting = true. subjectA & subjectB should have unique value |
subjectB |
String | No |
Subject B of the campaign. Mandatory 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' |
emailExpirationDate |
Object | No |
To reduce your carbon footprint, set an expiration date for your email. If supported, it will be automatically deleted from the recipient’s inbox, saving storage space and energy. |
emailExpirationDate.duration |
Integer | No |
Duration of the email expiry. maximum duration can be 3600 days or 480 weeks or 120 months. |
emailExpirationDate.unit |
String | No |
unit of the duration Valid values:
|
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. Mandatory if abTesting = true & 'recipients' is passed. 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 when abTesting is set to true. subjectA & subjectB are mandatory together & 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 Brevo 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
- Add HTTP Task to your workflow definition.
- 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.
- Click Test request to test run your request to the API and see the API's response.