Skip to main content
Server path: /brevo-email | Type: Application | PCID required: Yes

Tools

ToolDescription
brevo_email_block_new_domainAdd a new domain to the list of blocked domains
brevo_email_create_email_campaignCreate an email campaign
brevo_email_create_senderCreate email sender
brevo_email_create_smtp_templateCreate an email template
brevo_email_delete_blocked_domainUnblock an existing domain from the list of blocked domains
brevo_email_delete_campaignDelete an email campaign
brevo_email_delete_hardbouncesDelete hardbounces
brevo_email_delete_scheduled_email_by_idDelete scheduled emails by batchId or messageId
brevo_email_delete_senderDelete a sender
brevo_email_delete_smtp_blocked_contacts_by_emailUnblock or resubscribe a transactional contact
brevo_email_delete_smtp_log_by_identifierDelete an SMTP transactional log
brevo_email_delete_smtp_templateDelete an inactive email template
brevo_email_export_recipientsExport the recipients of an email campaign
brevo_email_get_ab_test_campaign_resultGet an A/B test email campaign results
brevo_email_get_aggregated_smtp_reportGet your transactional email activity aggregated over a period of time
brevo_email_get_blocked_domainsGet the list of blocked domains
brevo_email_get_campaignGet an email campaign report
brevo_email_get_campaignsReturn all your created email campaigns
brevo_email_get_event_reportGet all your transactional email activity (unaggregated events)
brevo_email_get_inbound_email_attachmentRetrieve inbound attachment with download token.
brevo_email_get_inbound_email_eventsGet the list of all the events for the received emails.
brevo_email_get_inbound_email_events_by_uuidFetch all events history for one particular received email.
brevo_email_get_ipsGet all the dedicated IPs for your account
brevo_email_get_ips_from_senderGet all the dedicated IPs for a specific sender
brevo_email_get_scheduled_email_by_idFetch scheduled emails by batchId or messageId
brevo_email_get_sendersGet email senders
brevo_email_get_shared_template_urlGet a shared template url
brevo_email_get_smstemplatesReturn all your created SMS templates
brevo_email_get_smtp_reportGet your transactional email activity aggregated per day
brevo_email_get_smtp_templateReturns the template information
brevo_email_get_smtp_templatesGet the list of email templates
brevo_email_get_transac_blocked_contactsGet the list of blocked or unsubscribed transactional contacts
brevo_email_get_transac_email_contentGet the personalized content of a sent transactional email
brevo_email_get_transac_emails_listGet the list of transactional emails on the basis of allowed filters
brevo_email_post_preview_smtp_email_templatesGenerate the rendered preview of transactional template
brevo_email_send_email_campaign_nowSend an email campaign immediately, based on campaignId
brevo_email_send_reportSend the report of a campaign
brevo_email_send_test_emailSend an email campaign to your test list
brevo_email_send_test_templateSend a template to your test list
brevo_email_send_transac_emailSend a transactional email
brevo_email_update_campaign_statusUpdate an email campaign status
brevo_email_update_email_campaignUpdate an email campaign
brevo_email_update_senderUpdate a sender
brevo_email_update_smtp_templateUpdate an email template
brevo_email_upload_image_to_galleryUpload an image to your account’s image gallery
brevo_email_validate_sender_by_otpValidate a sender using OTP

brevo_email_block_new_domain

Add a new domain to the list of blocked domains Parameters:
ParameterTypeRequiredDefaultDescription
domainstringYesname of the domain to be blocked

brevo_email_create_email_campaign

Create an email campaign Parameters:
ParameterTypeRequiredDefaultDescription
abTestingbooleanNoStatus 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
attachmentUrlstringNoAbsolute 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
emailExpirationDateobjectNoTo 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. Learn more about setting an email expiration date. For reference , https://help.brevo.com/hc/en-us/articles/4413566705298-Create-an-email-campaign
footerstringNoFooter of the email campaign
headerstringNoHeader of the email campaign
htmlContentstringNoMandatory if htmlUrl and templateId are empty. Body of the message (HTML). Must have more than 10 characters and be less than 1MB in size. Cannot be used together with htmlUrl or templateId.
htmlUrlstringNoMandatory if htmlContent and templateId are empty. URL to the message (HTML). Cannot be used together with htmlContent or templateId. For example: https://html.domain.com
increaseRateintegerNoMandatory if ipWarmupEnable is set to true. 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%.
initialQuotaintegerNoMandatory if ipWarmupEnable is set to true. Set an initial quota greater than 1 for warming up your ip. We recommend you set a value of 3000.
inlineImageActivationbooleanNoUse true to embedded the images in your email. Final size of the email should be less than 4MB. Campaigns with embedded images can not be sent to more than 5000 contacts
ipWarmupEnablebooleanNoAvailable for dedicated ip clients. Set this to true if you wish to warm up your ip.
mirrorActivebooleanNoUse true to enable the mirror link
namestringYesName of the campaign
paramsobjectNoPass 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
previewTextstringNoPreview text or preheader of the email campaign
recipientsobjectNoSegment ids and List ids to include/exclude from campaign
replyTostringNoEmail on which the campaign recipients will be able to reply to
scheduledAtstringNoSending UTC date-time (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). For example: 2017-06-01T12:30:00+02:00
sendAtBestTimebooleanNoSet this to true if you want to send your campaign at best time.
senderobjectYesSender 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. Passing both email and id will result in an error. For example: {“name”:“xyz”, “email”:“example@abc.com”} or {“name”:“xyz”, “id”:123}
splitRuleintegerNoAdd 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
subjectstringNoSubject of the campaign. Mandatory if abTesting is false. Ignored if abTesting is true.
subjectAstringNoSubject A of the campaign. Mandatory if abTesting = true. subjectA & subjectB should have unique value
subjectBstringNoSubject B of the campaign. Mandatory if abTesting = true. subjectA & subjectB should have unique value
tagstringNoTag of the campaign
templateIdintegerNoMandatory if htmlContent and htmlUrl are empty. Id of the transactional email template with status active. Used to copy only its content fetched from htmlContent/htmlUrl to an email campaign for RSS feature. Cannot be used together with htmlContent or htmlUrl.
toFieldstringNoTo 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
unsubscriptionPageIdstringNoEnter an unsubscription page id. The page id is a 24 digit alphanumeric id that can be found in the URL when editing the page. If not entered, then the default unsubscription page will be used.
updateFormIdstringNoMandatory 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. If not entered, then the default update profile form will be used.
utmCampaignstringNoCustomize the utm_campaign value. If this field is empty, the campaign name will be used. Only alphanumeric characters and spaces are allowed
winnerCriteriastringNoChoose the metrics that will determinate the winning version. Mandatory if splitRule >= 1 and < 50. If splitRule = 50, winnerCriteria is ignored if passed
winnerDelayintegerNoChoose 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, winnerDelay is ignored if passed

brevo_email_create_sender

Create email sender Parameters:
ParameterTypeRequiredDefaultDescription
emailstringYesFrom email to use for the sender. A verification email will be sent to this address.
ipsobject[]NoMandatory in case of dedicated IP. IPs to associate to the sender. Not required for standard accounts.
namestringYesFrom Name to use for the sender

brevo_email_create_smtp_template

Create an email template Parameters:
ParameterTypeRequiredDefaultDescription
attachmentUrlstringNoAbsolute 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’
htmlContentstringNoBody of the message (HTML version). The field must have more than 10 characters. REQUIRED if htmlUrl is empty
htmlUrlstringNoUrl which contents the body of the email message. REQUIRED if htmlContent is empty
isActivebooleanNoStatus of template. isActive = true means template is active and isActive = false means template is inactive
replyTostringNoEmail on which campaign recipients will be able to reply to
senderobjectYesSender 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}
subjectstringYesSubject of the template
tagstringNoTag of the template
templateNamestringYesName of the template
toFieldstringNoTo 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

brevo_email_delete_blocked_domain

Unblock an existing domain from the list of blocked domains Parameters:
ParameterTypeRequiredDefaultDescription
domainstringYesThe name of the domain to be deleted

brevo_email_delete_campaign

Delete an email campaign Parameters:
ParameterTypeRequiredDefaultDescription
campaignIdintegerYesid of the campaign

brevo_email_delete_hardbounces

Delete hardbounces Parameters:
ParameterTypeRequiredDefaultDescription
contactEmailstringNoTarget a specific email address
endDatestringNoEnding date (YYYY-MM-DD) of the time period for deletion. The hardbounces until this date will be deleted. Must be greater than or equal to the startDate
startDatestringNoStarting date (YYYY-MM-DD) of the time period for deletion. The hardbounces occurred after this date will be deleted. Must be less than or equal to the endDate

brevo_email_delete_scheduled_email_by_id

Delete scheduled emails by batchId or messageId Parameters:
ParameterTypeRequiredDefaultDescription
identifierstringYesThe batchId of scheduled emails batch (must be a valid UUIDv4) or the messageId of scheduled email (enclosed in angle brackets with @ sign, e.g. &lt;...@domain&gt;).

brevo_email_delete_sender

Delete a sender Parameters:
ParameterTypeRequiredDefaultDescription
senderIdintegerYesId of the sender

brevo_email_delete_smtp_blocked_contacts_by_email

Unblock or resubscribe a transactional contact Parameters:
ParameterTypeRequiredDefaultDescription
emailstringYescontact email (urlencoded) to unblock.

brevo_email_delete_smtp_log_by_identifier

Delete an SMTP transactional log Parameters:
ParameterTypeRequiredDefaultDescription
identifierstringYesMessageId or email address of the transactional log(s) to delete. Must be a valid message ID (enclosed in angle brackets with @ sign) or a valid email address.
from_datestringNoStarting date (YYYY-MM-DD) to narrow down logs for deletion
to_datestringNoEnding date (YYYY-MM-DD) to narrow down logs for deletion

brevo_email_delete_smtp_template

Delete an inactive email template Parameters:
ParameterTypeRequiredDefaultDescription
templateIdintegerYesid of the template

brevo_email_export_recipients

Export the recipients of an email campaign Parameters:
ParameterTypeRequiredDefaultDescription
campaignIdintegerYesId of the campaign
notifyURLstringNoWebhook called once the export process is finished. For reference, https://help.brevo.com/hc/en-us/articles/360007666479
recipientsTypestringNoType of recipients to export for a campaign

brevo_email_get_ab_test_campaign_result

Get an A/B test email campaign results Parameters:
ParameterTypeRequiredDefaultDescription
campaignIdintegerYesId of the A/B test campaign

brevo_email_get_aggregated_smtp_report

Get your transactional email activity aggregated over a period of time Parameters:
ParameterTypeRequiredDefaultDescription
startDatestringNoMandatory if endDate is used. Starting date of the report (YYYY-MM-DD). Must be lower than equal to endDate
endDatestringNoMandatory if startDate is used. Ending date of the report (YYYY-MM-DD). Must be greater than equal to startDate
daysintegerNoNumber of days in the past including today (positive integer, maximum 90). Not compatible with ‘startDate’ and ‘endDate’. Defaults to 90 if neither dates nor days are provided.
tagstringNoTag of the emails

brevo_email_get_blocked_domains

Get the list of blocked domains

brevo_email_get_campaign

Get an email campaign report Parameters:
ParameterTypeRequiredDefaultDescription
campaignIdintegerYesId of the campaign
statisticsstringNoFilter on the type of statistics required. Example: globalStats value will only fetch globalStats info of the campaign in the returned response. statsByDevice and statsByBrowser are only available when retrieving a single campaign (not in the list endpoint).
excludeHtmlContentbooleanNoUse this flag to exclude htmlContent from the response body. If set to true, htmlContent field will be returned as empty string in the response body

brevo_email_get_campaigns

Return all your created email campaigns Parameters:
ParameterTypeRequiredDefaultDescription
typestringNoFilter on the type of the campaigns
statusstringNoFilter on the status of the campaign
statisticsstringNoFilter on the type of statistics required. Example: globalStats value will only fetch globalStats info of the campaign in the returned response. This option only returns data for events that occurred in the last 6 months. For older campaigns, it is advisable to use the Get Campaign Report endpoint.
startDatestringNoMandatory if endDate is used. Starting (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to filter the sent email campaigns. Prefer to pass your timezone in date-time format for accurate result. Only available if status is not passed or is set to sent. The date range between startDate and endDate must not exceed 2 years. startDate must not be in the future.
endDatestringNoMandatory if startDate is used. Ending (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to filter the sent email campaigns. Prefer to pass your timezone in date-time format for accurate result. Only available if status is not passed or is set to sent. The date range between startDate and endDate must not exceed 2 years. endDate must not be in the future.
limitintegerNoNumber of documents per page
offsetintegerNoIndex of the first document in the page
sortstringNoSort the results in the ascending/descending order of record creation. Default order is descending if sort is not passed
excludeHtmlContentbooleanNoUse this flag to exclude htmlContent from the response body. If set to true, the htmlContent field will be returned as an empty string in the response body.
excludePdfAttachmentbooleanNoUse this flag to filter out campaigns that have a PDF attachment. If set to true, only campaigns without a PDF attachment (or with no attachment at all) will be returned.

brevo_email_get_event_report

Get all your transactional email activity (unaggregated events) Parameters:
ParameterTypeRequiredDefaultDescription
limitintegerNoNumber limitation for the result returned
offsetintegerNoBeginning point in the list to retrieve from.
startDatestringNoMandatory if endDate is used. Starting date of the report (YYYY-MM-DD). Must be lower than equal to endDate
endDatestringNoMandatory if startDate is used. Ending date of the report (YYYY-MM-DD). Must be greater than equal to startDate
daysintegerNoNumber of days in the past including today (positive integer, maximum 90). Not compatible with ‘startDate’ and ‘endDate’. Defaults to 30 if neither dates nor days are provided.
emailstringNoFilter the report for a specific email addresses
eventstringNoFilter the report for a specific event type
tagsstringNoFilter the report for tags (serialized and urlencoded array)
messageIdstringNoFilter on a specific message id
templateIdintegerNoFilter on a specific template id
sortstringNoSort the results in the ascending/descending order of record creation. Default order is descending if sort is not passed

brevo_email_get_inbound_email_attachment

Retrieve inbound attachment with download token. Parameters:
ParameterTypeRequiredDefaultDescription
downloadTokenstringYesToken to fetch a particular attachment

brevo_email_get_inbound_email_events

Get the list of all the events for the received emails. Parameters:
ParameterTypeRequiredDefaultDescription
senderstringNoEmail address of the sender.
startDatestringNoMandatory if endDate is used. Starting date (YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss.SSSZ) from which you want to fetch the list. Maximum time period that can be selected is 30 days. Must not be in the future.
endDatestringNoMandatory if startDate is used. Ending date (YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss.SSSZ) till which you want to fetch the list. Maximum time period that can be selected is 30 days. Must not be in the future.
limitintegerNoNumber of documents returned per page
offsetintegerNoIndex of the first document on the page
sortstringNoSort the results in the ascending/descending order of record creation

brevo_email_get_inbound_email_events_by_uuid

Fetch all events history for one particular received email. Parameters:
ParameterTypeRequiredDefaultDescription
uuidstringYesUUID to fetch events specific to received email

brevo_email_get_ips

Get all the dedicated IPs for your account

brevo_email_get_ips_from_sender

Get all the dedicated IPs for a specific sender Parameters:
ParameterTypeRequiredDefaultDescription
senderIdintegerYesId of the sender

brevo_email_get_scheduled_email_by_id

Fetch scheduled emails by batchId or messageId Parameters:
ParameterTypeRequiredDefaultDescription
identifierstringYesThe batchId of scheduled emails batch (must be a valid UUIDv4) or the messageId of scheduled email (enclosed in angle brackets with @ sign, e.g. &lt;...@domain&gt;). When using messageId, the limit, offset, sort, and status query parameters are ignored.
startDatestringNoMandatory if endDate is used. Starting date (YYYY-MM-DD) from which you want to fetch the list. Cannot be more than 30 days older than the current date.
endDatestringNoMandatory if startDate is used. Ending date (YYYY-MM-DD) till which you want to fetch the list. Maximum time period that can be selected is one month.
sortstringNoSort the results in the ascending/descending order of record creation. Default order is descending if sort is not passed. Not valid when identifier is messageId.
statusstringNoFilter the records by status of the scheduled email batch or message. Not valid when identifier is messageId.
limitintegerNoNumber of documents returned per page. Not valid when identifier is messageId.
offsetintegerNoIndex of the first document on the page. Not valid when identifier is messageId.

brevo_email_get_senders

Get email senders Parameters:
ParameterTypeRequiredDefaultDescription
ipstringNoFilter your senders for a specific ip. Available for dedicated IP usage only
domainstringNoFilter your senders for a specific domain

brevo_email_get_shared_template_url

Get a shared template url Parameters:
ParameterTypeRequiredDefaultDescription
campaignIdintegerYesId of the campaign or template

brevo_email_get_smstemplates

Return all your created SMS templates Parameters:
ParameterTypeRequiredDefaultDescription
limitintegerNoNumber of documents returned per page
offsetintegerNoIndex of the first document in the page
sortstringNoSort the results in the ascending/descending order of record creation. Default order is descending if sort is not passed

brevo_email_get_smtp_report

Get your transactional email activity aggregated per day Parameters:
ParameterTypeRequiredDefaultDescription
limitintegerNoNumber of documents returned per page
offsetintegerNoIndex of the first document on the page
startDatestringNoMandatory if endDate is used. Starting date of the report (YYYY-MM-DD)
endDatestringNoMandatory if startDate is used. Ending date of the report (YYYY-MM-DD)
daysintegerNoNumber of days in the past including today (positive integer, maximum 30). Not compatible with ‘startDate’ and ‘endDate’
tagstringNoTag of the emails
sortstringNoSort the results in the ascending/descending order of record creation. Default order is descending if sort is not passed

brevo_email_get_smtp_template

Returns the template information Parameters:
ParameterTypeRequiredDefaultDescription
templateIdobjectYesID of the template. Can be a numeric template ID or a custom template identifier string (alphanumeric, hyphens, and underscores only, max 64 characters, must start with a letter).

brevo_email_get_smtp_templates

Get the list of email templates Parameters:
ParameterTypeRequiredDefaultDescription
templateStatusbooleanNoFilter on the status of the template. Active = true, inactive = false
limitintegerNoNumber of documents returned per page
offsetintegerNoIndex of the first document in the page
sortstringNoSort the results in the ascending/descending order of record creation. Default order is descending if sort is not passed
editorTypestringNoFilter on the editor type used to create the template. Currently only richTextEditor is supported as a filter value.

brevo_email_get_transac_blocked_contacts

Get the list of blocked or unsubscribed transactional contacts Parameters:
ParameterTypeRequiredDefaultDescription
startDatestringNoMandatory if endDate is used. Starting date (YYYY-MM-DD) from which you want to fetch the blocked or unsubscribed contacts
endDatestringNoMandatory if startDate is used. Ending date (YYYY-MM-DD) till which you want to fetch the blocked or unsubscribed contacts
limitintegerNoNumber of documents returned per page
offsetintegerNoIndex of the first document on the page
sendersstring[]NoComma separated list of emails of the senders from which contacts are blocked or unsubscribed
sortstringNoSort the results in the ascending/descending order of record creation. Default order is descending if sort is not passed

brevo_email_get_transac_email_content

Get the personalized content of a sent transactional email Parameters:
ParameterTypeRequiredDefaultDescription
uuidstringYesUnique id of the transactional email that has been sent to a particular contact

brevo_email_get_transac_emails_list

Get the list of transactional emails on the basis of allowed filters Parameters:
ParameterTypeRequiredDefaultDescription
emailstringNoMandatory if templateId and messageId are not passed in query filters. Email address to which transactional email has been sent.
templateIdintegerNoMandatory if email and messageId are not passed in query filters. Id of the template that was used to compose transactional email.
messageIdstringNoMandatory if templateId and email are not passed in query filters. Message ID of the transactional email sent.
startDatestringNoMandatory if endDate is used. Starting date (YYYY-MM-DD) from which you want to fetch the list. Maximum time period that can be selected is one month.
endDatestringNoMandatory if startDate is used. Ending date (YYYY-MM-DD) till which you want to fetch the list. Maximum time period that can be selected is one month.
sortstringNoSort the results in the ascending/descending order of record creation. Default order is descending if sort is not passed
limitintegerNoNumber of documents returned per page
offsetintegerNoIndex of the first document in the page

brevo_email_post_preview_smtp_email_templates

Generate the rendered preview of transactional template Parameters:
ParameterTypeRequiredDefaultDescription
emailstringNoEmail of the contact.(Required if params not provided)
paramsobjectNoKey-value pairs of dynamic parameters for template rendering.(Required if email not provided) For example: {“Firstname”:“John”, “Lastname”:“Doe”}
templateIdintegerYesId of the template.

brevo_email_send_email_campaign_now

Send an email campaign immediately, based on campaignId Parameters:
ParameterTypeRequiredDefaultDescription
campaignIdintegerYesId of the campaign

brevo_email_send_report

Send the report of a campaign Parameters:
ParameterTypeRequiredDefaultDescription
campaignIdintegerYesId of the campaign
emailobjectYesCustom attributes for the report email.
languagestringNoLanguage of email content for campaign report sending.

brevo_email_send_test_email

Send an email campaign to your test list Parameters:
ParameterTypeRequiredDefaultDescription
campaignIdintegerYesId of the campaign
emailTostring[]NoList of the email addresses of the recipients whom you wish to send the test mail. If left empty, the test mail will be sent to your entire test list. You can not send more than 50 test emails per day.

brevo_email_send_test_template

Send a template to your test list Parameters:
ParameterTypeRequiredDefaultDescription
templateIdintegerYesId of the template
emailTostring[]NoList of the email addresses of the recipients whom you wish to send the test mail. If left empty, the test mail will be sent to your entire test list. You can not send more than 50 test emails per day.

brevo_email_send_transac_email

Send a transactional email Parameters:
ParameterTypeRequiredDefaultDescription
attachmentobject[]NoArray of attachment objects. Each attachment must include either an absolute URL (no local file paths) or base64-encoded content, along with the attachment filename. The name field is required when content is provided. Supported file extensions: 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, eps, odt, mp3, m4a, m4v, wma, ogg, flac, wav, aif, aifc, aiff, mp4, mov, avi, mkv, mpeg, mpg, wmv, pkpass, xlsm. When templateId is specified: if the template uses the New Template Language format, both url and content attachment types are supported; if the template uses the Old Template Language format, the attachment parameter is ignored.
batchIdstringNoUUIDv4 identifier for the scheduled batch of transactional emails. If omitted, a valid UUIDv4 batch identifier is automatically generated.
bccobject[]NoArray of BCC recipient objects. Each object contains an email address and an optional name.
ccobject[]NoArray of CC recipient objects. Each object contains an email address and an optional name.
headersobjectNoCustom email headers (non-standard headers) to include in the email. The sender.ip header can be set to specify the IP address used for sending transactional emails (dedicated IP users only). Header names must use Title-Case-Format (words separated by hyphens with the first letter of each word capitalized). Headers not in this format are automatically converted. Standard email headers are not supported. Example: &#123;"sender.ip":"1.2.3.4", "X-Mailin-custom":"some_custom_value", "Idempotency-Key":"abc-123"&#125;
htmlContentstringNoHTML body content of the email. Required when templateId is not provided. Ignored when templateId is provided.
messageVersionsobject[]NoArray of message version objects for sending customized email variants. The templateId can be customized per version only if a global templateId is provided. The htmlContent and textContent can be customized per version only if at least one of these is present in the global parameters. Global parameters such as to (required), bcc, cc, replyTo, and subject can be customized per version. Maximum total recipients per API request is 2000. Maximum recipients per message version is 99. Individual params objects must not exceed 100 KB. Cumulative params across all versions must not exceed 1000 KB. See https://developers.brevo.com/docs/batch-send-transactional-emails for detailed usage instructions.
paramsobjectNoKey-value pairs for template variable substitution. Only applicable when the template uses the New Template Language format.
replyToobjectNoReply-to email address (required) and optional display name. Recipients will use this address when replying to the email.
scheduledAtstringNoUTC date-time when the email should be sent (format: YYYY-MM-DDTHH:mm:ss.SSSZ). Include timezone information in the date-time value. Scheduled emails may be delayed by up to 5 minutes.
senderobjectNoSender information. Required when templateId is not provided. Specify either an email address (with optional name) or a sender ID. The name field is ignored when id is provided.
subjectstringNoEmail subject line. Required when templateId is not provided.
tagsstring[]NoArray of tags for categorizing and filtering emails
templateIdintegerNoTemplate identifier
textContentstringNoPlain text body content of the email. Ignored when templateId is provided.
toobject[]NoArray of recipient objects. Each object contains an email address and an optional display name. Required when messageVersions is not provided. Ignored when messageVersions is provided. Example: [&#123;"name":"Jimmy", "email":"jimmy@example.com"&#125;, &#123;"name":"Joe", "email":"joe@example.com"&#125;]

brevo_email_update_campaign_status

Update an email campaign status Parameters:
ParameterTypeRequiredDefaultDescription
campaignIdintegerYesId of the campaign
statusstringNoNote:- replicateTemplate status will be available only for template type campaigns.

brevo_email_update_email_campaign

Update an email campaign Parameters:
ParameterTypeRequiredDefaultDescription
campaignIdintegerYesId of the campaign
abTestingbooleanNoStatus 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
attachmentUrlstringNoAbsolute 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’
emailExpirationDateobjectNoTo 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.
footerstringNoFooter of the email campaign
headerstringNoHeader of the email campaign
htmlContentstringNoBody 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
htmlUrlstringNoUrl which contents the body of the email message. REQUIRED if htmlContent is empty
increaseRateintegerNoSet 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%.
initialQuotaintegerNoSet an initial quota greater than 1 for warming up your ip. We recommend you set a value of 3000.
inlineImageActivationbooleanNoStatus 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.
ipWarmupEnablebooleanNoAvailable for dedicated ip clients. Set this to true if you wish to warm up your ip.
mirrorActivebooleanNoStatus of mirror links in campaign. mirrorActive = false means mirror links are deactivated, & mirrorActive = true means mirror links are activated, in the campaign
namestringNoName of the campaign
paramsobjectNoPass 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
previewTextstringNoPreview text or preheader of the email campaign
recipientsobjectNoSegment ids and List ids to include/exclude from campaign
recurringbooleanNoFOR 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
replyTostringNoEmail on which campaign recipients will be able to reply to
scheduledAtstringNoUTC 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).
sendAtBestTimebooleanNoSet this to true if you want to send your campaign at best time. Note:- if true, warmup ip will be disabled.
senderobjectNoSender 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}
splitRuleintegerNoAdd 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
subjectstringNoSubject of the campaign
subjectAstringNoSubject A of the campaign. Mandatory if abTesting = true. subjectA & subjectB should have unique value
subjectBstringNoSubject B of the campaign. Mandatory if abTesting = true. subjectA & subjectB should have unique value
tagstringNoTag of the campaign
toFieldstringNoTo 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
unsubscriptionPageIdstringNoEnter an unsubscription page id. The page id is a 24 digit alphanumeric id that can be found in the URL when editing the page.
updateFormIdstringNoMandatory 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.
utmCampaignstringNoCustomize the utm_campaign value. If this field is empty, the campaign name will be used. Only alphanumeric characters and spaces are allowed
winnerCriteriastringNoChoose the metrics that will determinate the winning version. Mandatory if splitRule >= 1 and < 50. If splitRule = 50, winnerCriteria is ignored if passed
winnerDelayintegerNoChoose 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, winnerDelay is ignored if passed

brevo_email_update_sender

Update a sender Parameters:
ParameterTypeRequiredDefaultDescription
senderIdintegerYesId of the sender
emailstringNoFrom Email to update the sender
ipsobject[]NoOnly in case of dedicated IP. IPs to associate to the sender. If passed, will replace all the existing IPs. Not required for standard accounts.
namestringNoFrom Name to update the sender

brevo_email_update_smtp_template

Update an email template Parameters:
ParameterTypeRequiredDefaultDescription
templateIdobjectYesID of the template. Can be a numeric template ID or a custom template identifier string.
attachmentUrlstringNoAbsolute url of the attachment (no local file). Extensions 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
htmlContentstringNoRequired if htmlUrl is empty. If the template is designed using Drag & Drop editor via HTML content, then the design page will not have Drag & Drop editor access for that template. Body of the message (HTML must have more than 10 characters)
htmlUrlstringNoRequired if htmlContent is empty. URL to the body of the email (HTML)
isActivebooleanNoStatus of the template. isActive = false means template is inactive, isActive = true means template is active
replyTostringNoEmail on which campaign recipients will be able to reply to
senderobjectNoSender 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}
subjectstringNoSubject of the email
tagstringNoTag of the template
templateNamestringNoName of the template
toFieldstringNoTo 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

Upload an image to your account’s image gallery Parameters:
ParameterTypeRequiredDefaultDescription
imageUrlstringYesThe absolute url of the image (no local file). Maximum allowed size for image is 2MB. Allowed extensions for images are: #### jpeg, jpg, png, bmp, gif.
namestringNoName of the image.

brevo_email_validate_sender_by_otp

Validate a sender using OTP Parameters:
ParameterTypeRequiredDefaultDescription
senderIdintegerYesId of the sender
otpintegerNo6 digit OTP received on email