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

Tools

ToolDescription
brevo_messaging_create_conversations_agent_online_pingSets agent’s status to online for 2-3 minutes
brevo_messaging_create_conversations_messagesSend a message as an agent
brevo_messaging_create_conversations_pushed_messagesSend an automated message to a visitor
brevo_messaging_create_sms_campaignCreates an SMS campaign
brevo_messaging_create_whats_app_campaignCreate and Send a WhatsApp campaign
brevo_messaging_create_whats_app_templateCreate a WhatsApp template
brevo_messaging_delete_conversations_messages_by_idDelete a message sent by an agent
brevo_messaging_delete_conversations_pushed_messages_by_idDelete an automated message
brevo_messaging_delete_sms_campaignDelete an SMS campaign
brevo_messaging_delete_whats_app_campaignDelete a WhatsApp campaign
brevo_messaging_get_conversations_messages_by_idGet a message
brevo_messaging_get_conversations_pushed_messages_by_idGet an automated message
brevo_messaging_get_sms_campaignGet an SMS campaign
brevo_messaging_get_sms_campaignsReturns the information for all your created SMS campaigns
brevo_messaging_get_sms_eventsGet all your SMS activity (unaggregated events)
brevo_messaging_get_transac_aggregated_sms_reportGet your SMS activity aggregated over a period of time
brevo_messaging_get_transac_sms_reportGet your SMS activity aggregated per day
brevo_messaging_get_whats_app_campaignGet a WhatsApp campaign
brevo_messaging_get_whats_app_campaignsReturn all your created WhatsApp campaigns
brevo_messaging_get_whats_app_configGet your WhatsApp API account information
brevo_messaging_get_whats_app_templatesReturn all your created WhatsApp templates
brevo_messaging_get_whatsapp_event_reportGet all your WhatsApp activity (unaggregated events)
brevo_messaging_request_sms_recipient_exportExport an SMS campaign’s recipients
brevo_messaging_send_async_transactional_smsSend SMS message asynchronously to a mobile number
brevo_messaging_send_sms_campaign_nowSend your SMS campaign immediately
brevo_messaging_send_sms_reportSend an SMS campaign’s report
brevo_messaging_send_test_smsSend a test SMS campaign
brevo_messaging_send_transac_smsSend SMS message to a mobile number
brevo_messaging_send_whats_app_template_approvalSend your WhatsApp template for approval
brevo_messaging_send_whatsapp_messageSend a WhatsApp message
brevo_messaging_update_conversations_messages_by_idUpdate a message sent by an agent
brevo_messaging_update_conversations_pushed_messages_by_idUpdate an automated message
brevo_messaging_update_conversations_visitor_groupSet visitor group assignment
brevo_messaging_update_sms_campaignUpdate an SMS campaign
brevo_messaging_update_sms_campaign_statusUpdate a campaign’s status
brevo_messaging_update_whats_app_campaignUpdate a WhatsApp campaign

brevo_messaging_create_conversations_agent_online_ping

Sets agent’s status to online for 2-3 minutes Parameters:
ParameterTypeRequiredDefaultDescription
agentEmailstringNoAgent’s email address. When sending online pings from a standalone system, it’s hard to maintain a 1-to-1 relationship between the users of both systems. In this case, an agent can be specified by their email address. If there’s no agent with the specified email address in your Brevo organization, a dummy agent will be created automatically.
agentIdstringNoAgent ID. It can be found on the agent’s page or received <a href=“https://developers.brevo.com/docs/conversations-webhooks”&gt;from a webhook</a>. Alternatively, you can use agentEmail + agentName + receivedFrom instead (all 3 fields required).
agentNamestringNoAgent’s name.
receivedFromstringNoMark your messages to distinguish messages created by you from the others.

brevo_messaging_create_conversations_messages

Send a message as an agent Parameters:
ParameterTypeRequiredDefaultDescription
agentEmailstringNoAgent’s email address. When sending messages from a standalone system, it’s hard to maintain a 1-to-1 relationship between the users of both systems. In this case, an agent can be specified by their email address.
agentIdstringNoAgent ID. It can be found on the agent’s page or received <a href=“https://developers.brevo.com/docs/conversations-webhooks”&gt;from a webhook</a>. Alternatively, you can use agentEmail + agentName + receivedFrom instead (all 3 fields required).
agentNamestringNoAgent’s name.
receivedFromstringNoMark your messages to distinguish messages created by you from the others.
textstringYesMessage text.
visitorIdstringYesVisitor’s ID received <a href=“https://developers.brevo.com/docs/conversations-webhooks”&gt;from a webhook</a> or generated by you to <a href=“https://developers.brevo.com/docs/customize-the-widget#identifying-existing-users”&gt;bind an existing user account to Conversations</a>.

brevo_messaging_create_conversations_pushed_messages

Send an automated message to a visitor Parameters:
ParameterTypeRequiredDefaultDescription
agentIdstringNoAgent ID. It can be found on the agent’s page or received <a href=“https://developers.brevo.com/docs/conversations-webhooks”&gt;from a webhook</a>.
groupIdstringNoGroup ID. It can be found on the group’s page.
textstringYesMessage text.
visitorIdstringYesVisitor’s ID received <a href=“https://developers.brevo.com/docs/conversations-webhooks”&gt;from a webhook</a> or generated by you to <a href=“https://developers.brevo.com/docs/customize-the-widget#identifying-existing-users”&gt;bind an existing user account to Conversations</a>.

brevo_messaging_create_sms_campaign

Creates an SMS campaign Parameters:
ParameterTypeRequiredDefaultDescription
contentstringYesContent of the message. The maximum characters used per SMS is 160, if used more than that, it will be counted as more than one SMS.
namestringYesName of the campaign
organisationPrefixstringNoA recognizable prefix will ensure your audience knows who you are. Recommended by U.S. carriers. This will be added as your Brand Name before the message content. Prefer verifying maximum length of 160 characters including this prefix in message content to avoid multiple sending of same sms.
recipientsobjectNoThe recipients value
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.
senderstringYesName of the sender. The number of characters is limited to 11 for alphanumeric characters and 15 for numeric characters
unicodeEnabledbooleanNoFormat of the message. It indicates whether the content should be treated as unicode or not.
unsubscribeInstructionstringNoInstructions to unsubscribe from future communications. Recommended by U.S. carriers. Must include STOP keyword. This will be added as instructions after the end of message content. Prefer verifying maximum length of 160 characters including this instructions in message content to avoid multiple sending of same sms.

brevo_messaging_create_whats_app_campaign

Create and Send a WhatsApp campaign Parameters:
ParameterTypeRequiredDefaultDescription
namestringYesName of the WhatsApp campaign creation
recipientsobjectYesSegment ids and List ids to include/exclude from campaign
scheduledAtstringYesSending UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ). **Prefer to pass your timezone in date-time format for accurate result.For example: 2017-06-01T12:30:00+02:00
templateIdintegerYesId of the WhatsApp template in approved state

brevo_messaging_create_whats_app_template

Create a WhatsApp template Parameters:
ParameterTypeRequiredDefaultDescription
bodyTextstringYesBody of the template. Maximum allowed characters are 1024
categorystringYesCategory of the template
headerTextstringNoText content of the header in the template. Maximum allowed characters are 45 Use this field to add text content in template header and if mediaUrl is empty
languagestringYesLanguage of the template. For Example : en for English
mediaUrlstringNoAbsolute url of the media file (no local file) for the header. Use this field in you want to add media in Template header and headerText is empty Allowed extensions for media files are: #### jpeg | png | mp4 | pdf
namestringYesName of the template
sourcestringNosource of the template

brevo_messaging_delete_conversations_messages_by_id

Delete a message sent by an agent Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesID of the message

brevo_messaging_delete_conversations_pushed_messages_by_id

Delete an automated message Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesID of the message

brevo_messaging_delete_sms_campaign

Delete an SMS campaign Parameters:
ParameterTypeRequiredDefaultDescription
campaignIdintegerYesid of the SMS campaign

brevo_messaging_delete_whats_app_campaign

Delete a WhatsApp campaign Parameters:
ParameterTypeRequiredDefaultDescription
campaignIdintegerYesid of the campaign

brevo_messaging_get_conversations_messages_by_id

Get a message Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesID of the message

brevo_messaging_get_conversations_pushed_messages_by_id

Get an automated message Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesID of the message sent previously

brevo_messaging_get_sms_campaign

Get an SMS campaign Parameters:
ParameterTypeRequiredDefaultDescription
campaignIdintegerYesid of the SMS campaign

brevo_messaging_get_sms_campaigns

Returns the information for all your created SMS campaigns Parameters:
ParameterTypeRequiredDefaultDescription
statusstringNoStatus of campaign.
startDatestringNoMandatory if endDate is used. Starting (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to filter the sent SMS 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. 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 SMS 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. endDate must not be in the future.
limitintegerNoNumber of documents per page
offsetintegerNoBeginning point in the list to retrieve from.
sortstringNoSort the results in the ascending/descending order of record creation. Default order is descending if sort is not passed

brevo_messaging_get_sms_events

Get all your SMS activity (unaggregated events) Parameters:
ParameterTypeRequiredDefaultDescription
limitintegerNoNumber of documents per page
startDatestringNoMandatory if endDate is used. Starting date (YYYY-MM-DD) of the report
endDatestringNoMandatory if startDate is used. Ending date (YYYY-MM-DD) of the report
offsetintegerNoIndex of the first document of the page
daysintegerNoNumber of days in the past including today (positive integer). Not compatible with ‘startDate’ and ‘endDate’
phoneNumberstringNoFilter the report for a specific phone number
eventstringNoFilter the report for specific events
tagsstringNoFilter the report for specific tags passed as a serialized urlencoded array
sortstringNoSort the results in the ascending/descending order of record creation. Default order is descending if sort is not passed

brevo_messaging_get_transac_aggregated_sms_report

Get your SMS activity aggregated over a period of time Parameters:
ParameterTypeRequiredDefaultDescription
startDatestringNoMandatory if endDate is used. Starting date (YYYY-MM-DD) of the report
endDatestringNoMandatory if startDate is used. Ending date (YYYY-MM-DD) of the report
daysintegerNoNumber of days in the past including today (positive integer). Not compatible with startDate and endDate
tagstringNoFilter on a tag

brevo_messaging_get_transac_sms_report

Get your SMS activity aggregated per day Parameters:
ParameterTypeRequiredDefaultDescription
startDatestringNoMandatory if endDate is used. Starting date (YYYY-MM-DD) of the report
endDatestringNoMandatory if startDate is used. Ending date (YYYY-MM-DD) of the report
daysintegerNoNumber of days in the past including today (positive integer). Not compatible with ‘startDate’ and ‘endDate’
tagstringNoFilter on a tag
sortstringNoSort the results in the ascending/descending order of record creation. Default order is descending if sort is not passed

brevo_messaging_get_whats_app_campaign

Get a WhatsApp campaign Parameters:
ParameterTypeRequiredDefaultDescription
campaignIdintegerYesId of the campaign

brevo_messaging_get_whats_app_campaigns

Return all your created WhatsApp campaigns Parameters:
ParameterTypeRequiredDefaultDescription
startDatestringNoMandatory if endDate is used. Starting (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to filter the WhatsApp campaigns created. Prefer to pass your timezone in date-time format for accurate result
endDatestringNoMandatory if startDate is used. Ending (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to filter the WhatsApp campaigns created. Prefer to pass your timezone in date-time format for accurate result
limitintegerNoNumber of documents per page
offsetintegerNoIndex of the first document in the page
sortstringNoSort the results in the ascending/descending order of record modification. Default order is descending if sort is not passed

brevo_messaging_get_whats_app_config

Get your WhatsApp API account information

brevo_messaging_get_whats_app_templates

Return all your created WhatsApp templates Parameters:
ParameterTypeRequiredDefaultDescription
startDatestringNoMandatory if endDate is used. Starting (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to filter the templates created. Prefer to pass your timezone in date-time format for accurate result
endDatestringNoMandatory if startDate is used. Ending (urlencoded) UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) to filter the templates created. Prefer to pass your timezone in date-time format for accurate result
limitintegerNoNumber of documents per page
offsetintegerNoIndex of the first document in the page
sortstringNoSort the results in the ascending/descending order of record modification. Default order is descending if sort is not passed
sourcestringNosource of the template

brevo_messaging_get_whatsapp_event_report

Get all your WhatsApp 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). Not compatible with ‘startDate’ and ‘endDate’
contactNumberstringNoFilter results for specific contact (WhatsApp Number with country code. Example, 85264318721)
eventstringNoFilter the report for a specific event type
sortstringNoSort the results in the ascending/descending order of record creation. Default order is descending if sort is not passed

brevo_messaging_request_sms_recipient_export

Export an SMS campaign’s recipients Parameters:
ParameterTypeRequiredDefaultDescription
campaignIdintegerYesid of the campaign
notifyURLstringNoURL that will be called once the export process is finished. For reference, https://help.brevo.com/hc/en-us/articles/360007666479
recipientsTypestringNoFilter the recipients based on how they interacted with the campaign

brevo_messaging_send_async_transactional_sms

Send SMS message asynchronously to a mobile number Parameters:
ParameterTypeRequiredDefaultDescription
organisationPrefixstringNoA recognizable prefix will ensure your audience knows who you are. Recommended by U.S. carriers. This will be added as your Brand Name before the message content. Prefer verifying maximum length of 160 characters including this prefix in message content to avoid multiple sending of same sms.
paramsobjectNoPass the set of attributes to customize the template. For example, {“FNAME”:“Joe”, “LNAME”:“Doe”}. These are the placeholder variables in the template that will be replaced with the corresponding values passed in the params object. Applicable only if templateId is used.
recipientstringYesMobile number to send SMS with the country code. Must contain between 6 and 15 digits, optionally prefixed with ’+’.
senderstringYesName of the sender. The number of characters is limited to 11 for alphanumeric characters and 15 for numeric characters. Alphanumeric sender names (up to 11 characters) must contain only letters and digits. Numeric sender names (12-15 characters) must contain only digits.
tagstring[]NoTag of the message. Can be a single string or an array of strings (maximum 10 tags). Each tag must be a non-empty string.
typestringNoType of the SMS. Marketing SMS messages are those sent typically with marketing content. Transactional SMS messages are sent to individuals and are triggered in response to some action, such as a sign-up, purchase, etc.
unicodeEnabledbooleanNoFormat of the message. It indicates whether the content should be treated as unicode or not.
webUrlstringNoWebhook to call for each event triggered by the message (delivered etc.)

brevo_messaging_send_sms_campaign_now

Send your SMS campaign immediately Parameters:
ParameterTypeRequiredDefaultDescription
campaignIdintegerYesid of the campaign

brevo_messaging_send_sms_report

Send an SMS campaign’s report Parameters:
ParameterTypeRequiredDefaultDescription
campaignIdintegerYesid of the campaign
emailobjectYesCustom attributes for the report email.
languagestringNoLanguage of email content for campaign report sending.

brevo_messaging_send_test_sms

Send a test SMS campaign Parameters:
ParameterTypeRequiredDefaultDescription
campaignIdintegerYesId of the SMS campaign
phoneNumberstringNoMobile number of the recipient with the country code. This number must belong to one of your contacts in Brevo account and must not be blacklisted

brevo_messaging_send_transac_sms

Send SMS message to a mobile number Parameters:
ParameterTypeRequiredDefaultDescription
organisationPrefixstringNoA recognizable prefix will ensure your audience knows who you are. Recommended by U.S. carriers. This will be added as your Brand Name before the message content. Prefer verifying maximum length of 160 characters including this prefix in message content to avoid multiple sending of same sms.
paramsobjectNoPass the set of attributes to customize the template. For example, {“FNAME”:“Joe”, “LNAME”:“Doe”}. These are the placeholder variables in the template that will be replaced with the corresponding values passed in the params object. Applicable only if templateId is used.
recipientstringYesMobile number to send SMS with the country code. Must contain between 6 and 15 digits, optionally prefixed with ’+’.
senderstringYesName of the sender. The number of characters is limited to 11 for alphanumeric characters and 15 for numeric characters. Alphanumeric sender names (up to 11 characters) must contain only letters and digits. Numeric sender names (12-15 characters) must contain only digits.
tagstring[]NoTag of the message. Can be a single string or an array of strings (maximum 10 tags). Each tag must be a non-empty string.
typestringNoType of the SMS. Marketing SMS messages are those sent typically with marketing content. Transactional SMS messages are sent to individuals and are triggered in response to some action, such as a sign-up, purchase, etc.
unicodeEnabledbooleanNoFormat of the message. It indicates whether the content should be treated as unicode or not.
webUrlstringNoWebhook to call for each event triggered by the message (delivered etc.)

brevo_messaging_send_whats_app_template_approval

Send your WhatsApp template for approval Parameters:
ParameterTypeRequiredDefaultDescription
templateIdintegerYesid of the template

brevo_messaging_send_whatsapp_message

Send a WhatsApp message Parameters:
ParameterTypeRequiredDefaultDescription
bodyobjectYesValues to send WhatsApp message

brevo_messaging_update_conversations_messages_by_id

Update a message sent by an agent Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesID of the message
textstringNoThe new message text.

brevo_messaging_update_conversations_pushed_messages_by_id

Update an automated message Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesID of the message
textstringNoThe new message text.

brevo_messaging_update_conversations_visitor_group

Set visitor group assignment Parameters:
ParameterTypeRequiredDefaultDescription
groupIdobjectNoGroup ID. It can be found on group’s page.

brevo_messaging_update_sms_campaign

Update an SMS campaign Parameters:
ParameterTypeRequiredDefaultDescription
campaignIdintegerYesid of the SMS campaign
contentstringNoContent of the message. The maximum characters used per SMS is 160, if used more than that, it will be counted as more than one SMS
namestringNoName of the campaign
organisationPrefixstringNoA recognizable prefix will ensure your audience knows who you are. Recommended by U.S. carriers. This will be added as your Brand Name before the message content. Prefer verifying maximum length of 160 characters including this prefix in message content to avoid multiple sending of same sms.
recipientsobjectNoThe recipients value
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.
senderstringNoName of the sender. The number of characters is limited to 11 for alphanumeric characters and 15 for numeric characters
unicodeEnabledbooleanNoFormat of the message. It indicates whether the content should be treated as unicode or not.
unsubscribeInstructionstringNoInstructions to unsubscribe from future communications. Recommended by U.S. carriers. Must include STOP keyword. This will be added as instructions after the end of message content. Prefer verifying maximum length of 160 characters including this instructions in message content to avoid multiple sending of same sms.

brevo_messaging_update_sms_campaign_status

Update a campaign’s status Parameters:
ParameterTypeRequiredDefaultDescription
campaignIdintegerYesid of the campaign
statusstringNoNote:- replicateTemplate status will be available only for template type campaigns.

brevo_messaging_update_whats_app_campaign

Update a WhatsApp campaign Parameters:
ParameterTypeRequiredDefaultDescription
campaignIdintegerYesid of the campaign
campaignNamestringNoName of the campaign
campaignStatusstringNoStatus of the campaign
recipientsobjectNoSegment ids and List ids to include/exclude from campaign
rescheduleForstringNoReschedule the sending UTC date-time (YYYY-MM-DDTHH:mm:ss.SSSZ) of campaign. **Prefer to pass your timezone in date-time format for accurate result.For example: 2017-06-01T12:30:00+02:00 Use this field to update the scheduledAt of any existing draft or scheduled WhatsApp campaign.